home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / dfl311.zip / DFL.DOC < prev    next >
Text File  |  1992-01-09  |  116KB  |  2,464 lines
  1.  
  2.  
  3.  
  4.  
  5.                          DUPLICATE FILE LOCATOR
  6.                               Version 3.11
  7.  
  8.                            Table of Contents
  9.  
  10.                                Topic                          Page
  11.  
  12.         1         Introduction to DFL. . . . . . . . . . . .  4
  13.         1.1       DFL Overview . . . . . . . . . . . . . . .  4
  14.         1.2       System Requirements. . . . . . . . . . . .  5
  15.         1.3       Technical Support. . . . . . . . . . . . .  6
  16.         1.4       Registration Info. . . . . . . . . . . . .  6
  17.         1.5       Software License . . . . . . . . . . . . .  7
  18.  
  19.  
  20.         2         Using DFL. . . . . . . . . . . . . . . . .  8
  21.         2.1       Command Line Options . . . . . . . . . . .  8
  22.         2.1.1     /?  List Options . . . . . . . . . . . . .  8
  23.         2.1.2     /d  Drive List . . . . . . . . . . . . . .  8
  24.         2.1.3     /w  Working Disk . . . . . . . . . . . . .  9
  25.         2.1.4     /f  Filename Mask. . . . . . . . . . . . .  9
  26.         2.1.5     /m  Scan Mode. . . . . . . . . . . . . . . 10
  27.         2.1.6     /l  List Output File & Auto Mode . . . . . 10
  28.         2.1.7     /mono  Use monochrome colors . . . . . . . 10
  29.         2.2       Environment Variables. . . . . . . . . . . 11
  30.         2.2.1     DFLDISK=  Working Disk . . . . . . . . . . 11
  31.         2.2.2     DFLCFG=   Save File Directory. . . . . . . 11
  32.         2.3       The Interactive Interface. . . . . . . . . 12
  33.         2.3.1     Menu or Non-menu Access. . . . . . . . . . 12
  34.         2.3.2     Help System. . . . . . . . . . . . . . . . 13
  35.         2.3.3     Scan Status Window . . . . . . . . . . . . 13
  36.         2.3.4     Scan Style Window. . . . . . . . . . . . . 13
  37.         2.3.5     Disk Status Window . . . . . . . . . . . . 13
  38.         2.3.6     Duplicate List Window (Non-menu mode). . . 14
  39.         2.4       Running DFL. . . . . . . . . . . . . . . . 14
  40.         2.4.1     Unattended . . . . . . . . . . . . . . . . 14
  41.         2.4.2     A Fresh Start. . . . . . . . . . . . . . . 14
  42.         2.4.3     Resorting  . . . . . . . . . . . . . . . . 14
  43.         2.5       Duplicate File Search Modes. . . . . . . . 15
  44.         2.5.1     Name Mode. . . . . . . . . . . . . . . . . 15
  45.         2.5.2     FastAlias Mode . . . . . . . . . . . . . . 15
  46.         2.5.3     FullAlias Mode . . . . . . . . . . . . . . 16
  47.         2.5.4     Length Mode. . . . . . . . . . . . . . . . 16
  48.         2.5.5     Partial Name Mode. . . . . . . . . . . . . 16
  49.         2.5.6     Dos Path Mode. . . . . . . . . . . . . . . 16
  50.         2.6       The Filename Mask. . . . . . . . . . . . . 17
  51.         2.7       The Drive Scan List. . . . . . . . . . . . 17
  52.         2.8       Saving the Duplicate List. . . . . . . . . 17
  53.                                                        Page 2
  54.  
  55.  
  56.         3         DFL Online Functions . . . . . . . . . . . 17
  57.         3.1       Overview . . . . . . . . . . . . . . . . . 17
  58.         3.1.1     The Menu Window. . . . . . . . . . . . . . 17
  59.         3.1.2     The Duplicate Window . . . . . . . . . . . 18
  60.         3.1.3     The File View Window . . . . . . . . . . . 19
  61.         3.2       Global Functions . . . . . . . . . . . . . 19
  62.         3.2.1     ESC    Menu & Non-menu Toggle. . . . . . . 19
  63.         3.2.2     Alt-H  Help Menu . . . . . . . . . . . . . 19
  64.         3.2.3     Alt-S  Setup Menu. . . . . . . . . . . . . 20
  65.         3.2.4     Alt-R  Run Menu. . . . . . . . . . . . . . 20
  66.         3.2.5     Alt-E  Exit Menu . . . . . . . . . . . . . 20
  67.         3.2.6     Alt-X  Exit DFL. . . . . . . . . . . . . . 20
  68.         3.2.7     Home   Top of List . . . . . . . . . . . . 21
  69.         3.2.8     End    Bottom of List. . . . . . . . . . . 21
  70.         3.2.9     PgUp   Next Page in List . . . . . . . . . 21
  71.         3.2.10    PgDn   Previous Page in List . . . . . . . 21
  72.         3.2.11    F1     Call for Help . . . . . . . . . . . 21
  73.         3.2.12    SF1    Display Help Topics . . . . . . . . 22
  74.         3.2.13    F2     Drive Selection . . . . . . . . . . 22
  75.         3.2.14    F3     Name Mask Selection . . . . . . . . 22
  76.         3.2.15    F4     Scan Mode Selection . . . . . . . . 22
  77.         3.2.16    F5     Begin Scan. . . . . . . . . . . . . 23
  78.         3.2.17    SF5    Resort Scan . . . . . . . . . . . . 23
  79.         3.2.18    F6     Select First File for Comparison. . 23
  80.         3.2.19    F7     Start Binary File Comparison. . . . 23
  81.         3.2.20    F8     Delete One or More Files. . . . . . 24
  82.         3.2.21    F9     Write Duplicate List. . . . . . . . 24
  83.         3.2.22    F10    View File Contents. . . . . . . . . 24
  84.         3.2.23    'F'    Start ASCII File Comparison . . . . 24
  85.         3.2.24    'T'    Toggle File Tag . . . . . . . . . . 25
  86.         3.2.25    'U'    Untag all Files . . . . . . . . . . 25
  87.         3.2.26    'S'    Shell to DOS. . . . . . . . . . . . 25
  88.         3.2.27    ^C-Z   Display Drive Statistics. . . . . . 25
  89.                                                        Page 3
  90.  
  91.  
  92.         4         DFL Archive Subsystem. . . . . . . . . . . 26
  93.         4.1       Overview . . . . . . . . . . . . . . . . . 26
  94.         4.2       Defining an Archive. . . . . . . . . . . . 26
  95.         4.2.1     Basic Parameters . . . . . . . . . . . . . 26
  96.         4.2.1.1   Title. . . . . . . . . . . . . . . . . . . 26
  97.         4.2.1.2   Extension. . . . . . . . . . . . . . . . . 27
  98.         4.2.1.3   Enable/Disable . . . . . . . . . . . . . . 27
  99.         4.2.1.4   Screen Save. . . . . . . . . . . . . . . . 27
  100.         4.2.2     Archive Programs . . . . . . . . . . . . . 27
  101.         4.2.2.1   Lister Program & Parameters. . . . . . . . 28
  102.         4.2.2.2   Deleter Program & Parameters . . . . . . . 29
  103.         4.2.2.3   Extractor Program & Parameters . . . . . . 29
  104.         4.2.2.4   Compressor Program & Parameters. . . . . . 30
  105.         4.3.3     The Test Run . . . . . . . . . . . . . . . 30
  106.         4.3.4     Archive Lister Output. . . . . . . . . . . 31
  107.         4.3.4.1   Name . . . . . . . . . . . . . . . . . . . 31
  108.         4.3.4.2   Extension. . . . . . . . . . . . . . . . . 31
  109.         4.3.4.3   Length . . . . . . . . . . . . . . . . . . 31
  110.         4.3.4.4   Time . . . . . . . . . . . . . . . . . . . 31
  111.         4.3.4.5   Date . . . . . . . . . . . . . . . . . . . 32
  112.  
  113.         5         DFL File Viewing System. . . . . . . . . . 32
  114.         5.1       Overview . . . . . . . . . . . . . . . . . 32
  115.         5.2       Screen Layout. . . . . . . . . . . . . . . 32
  116.         5.3       Viewer Commands. . . . . . . . . . . . . . 32
  117.         5.3.1     F1 - Quick Help. . . . . . . . . . . . . . 32
  118.         5.3.2     Home & End . . . . . . . . . . . . . . . . 32
  119.         5.3.3     Page Keys. . . . . . . . . . . . . . . . . 33
  120.         5.3.4     Arrow Keys . . . . . . . . . . . . . . . . 33
  121.         5.3.5     ^Home. . . . . . . . . . . . . . . . . . . 33
  122.         5.3.6     ^PgUp & ^PgDn. . . . . . . . . . . . . . . 33
  123.         5.3.7     ^Right & ^Left . . . . . . . . . . . . . . 33
  124.         5.3.8     'W' - Mask High Bits . . . . . . . . . . . 33
  125.         5.3.9     'T' - Tab Toggle . . . . . . . . . . . . . 33
  126.         5.3.10    F2 - Print File. . . . . . . . . . . . . . 33
  127.  
  128.  
  129.         6         Useful Topics. . . . . . . . . . . . . . . 34
  130.         6.1       Users' Questions and Answers . . . . . . . 34
  131.         6.2       DFL Temporary Files & Directories. . . . . 38
  132.         6.3       DOS stack overflow . . . . . . . . . . . . 39
  133.         6.4       Error messages . . . . . . . . . . . . . . 39
  134.         6.4.1     Online Errors. . . . . . . . . . . . . . . 39
  135.         6.4.2     Exit Errors. . . . . . . . . . . . . . . . 47
  136.                                                        Page 4
  137.  
  138.  
  139.         1         Introduction to DFL
  140.  
  141.         In this section, a brief introduction to the capabilities of  DFL 
  142.         is  provided.   Complete information on all of  these  topics  is 
  143.         provided in subsequent sections.
  144.  
  145.         This  manual  sometimes  mentions  other  software  programs   or 
  146.         products.   In  all such cases, any trademarked material  is  the 
  147.         property of the rightful owners.
  148.  
  149.         
  150.         1.1       DFL Overview
  151.  
  152.         Duplicate  File  Locator is a complete software  system  used  to 
  153.         locate, view, compare and delete duplicate files on your computer 
  154.         system.   No   matter  where  the  files   reside:   in   various 
  155.         subdirectories,  on network drives, or even in archive  files  of 
  156.         various  formats,  DFL will find them for you, and allow  you  to 
  157.         view, delete or retain them as you see fit.
  158.  
  159.         After DFL has assembled a list of all of the files to be  consid-
  160.         ered, DFL will search for duplicates in one of two ways.  We call 
  161.         these  NAME mode and ALIAS mode.  In NAME mode, DFL searches  its 
  162.         file list for files which have the same name; in ALIAS mode,  DFL 
  163.         looks  for files which have the same data.  For example, in  NAME 
  164.         mode,  DFL could tell you that one of your files  "SOURCE.C"  has 
  165.         been  copied into any number of places.  In alias mode, DFL  will 
  166.         tell  you that "SOURCE.C" and "SOURCE.BAK" have exactly the  same 
  167.         contents.
  168.  
  169.         DFL version 2.61 could build a list of approximately 8,000  files 
  170.         over  any number of drives.  Beginning with DFL version 3.00,  we 
  171.         have  introduced a virtual memory system to help us  build  large 
  172.         lists of files.  We can now build a list limited only by the free 
  173.         disk  space  you  have to hold our data tables.   DFL  will  need 
  174.         approximately 1 megabyte of disk space for every 25,000 files.
  175.  
  176.         DFL  provides  a number of options particularly  useful  in  NAME 
  177.         mode.   For example, different versions of files  sometimes  have 
  178.         the  version number as part of the file name.  For  example,  DFL 
  179.         has been released in the past as "DFL110", "DFL130", "DFL150" and 
  180.         "DFL261".   By  using the 3 character masking  option,  DFL  will 
  181.         locate  all of these as NAME mode duplicates.  In this  way,  you 
  182.         can see which is the most recent version resident on your  system 
  183.         or network.  We allow you to set any number of characters as  the 
  184.         width to match.
  185.  
  186.         In  NAME mode, files with the same or similar names are  located, 
  187.         but  the contents may be different.  DFL gives you the option  of 
  188.         comparing any two files to see if the contents are the same.   In 
  189.         ALIAS  mode, this comparison is already done for you as  part  of 
  190.         the search process.
  191.                                                        Page 5
  192.  
  193.  
  194.         Many of us,  especially BBS sysops, use file archive programs  to 
  195.         get more files on our disks.  DFL will use your archive  programs 
  196.         to  search for, view or delete files stored inside  your  archive 
  197.         files.   We have tested DFL with ZIP, PAK, ZOO, LZH and  ARC  ar-
  198.         chive  programs successfully.  While we haven't tested  DFL  with 
  199.         all versions of these programs, or any other programs, we know of 
  200.         no  reason why DFL should not work.  If you have any problems  in 
  201.         this area, or any other, please let us know so we can take appro-
  202.         priate  steps.   DFL will even find duplicates  which  reside  in 
  203.         different archive formats.
  204.  
  205.         After  DFL  has searched the file list, any duplicate  files  are 
  206.         displayed  in  the "duplicate window", with the  drive  and  path 
  207.         along  which each file was found, the file length, and  the  file 
  208.         date and time.
  209.  
  210.         You  may  scroll through the duplicate window, compare  pairs  of 
  211.         files,  view  individual files, and tag files for  deletion.   In 
  212.         addition,  you may write the contents of the duplicate window  to 
  213.         an ASCII file so you can review the list off-line.
  214.  
  215.         DFL will allow you to compare files using either a binary,  byte-
  216.         by-byte  comparison, or by using your ASCII file comparison  pro-
  217.         gram  FC.EXE.   The ASCII comparison is particularly  helpful  in 
  218.         checking the differences between to versions of the "same" file.
  219.  
  220.         DFL offers COMPLETE ARCHIVE SUPPORT. This means that files  which 
  221.         are compressed and stored in archives can be handled exactly like 
  222.         normal  files. They can be viewed, deleted or compared  to  other 
  223.         files regardless of the type of archive(s) in which they  reside. 
  224.         Their host archives will be treated as directories. Also,  though 
  225.         implemented  only  as  a setup/diagnostic feature,  DFL  has  the 
  226.         ability  to  add  files  to  archives  using  the   corresponding 
  227.         archive's compression formats.
  228.  
  229.         DFL includes a comprehensive 'archive definition' subsystem which 
  230.         will  allow  you  to  customize it to interface  with  up  to  10 
  231.         different  archive  compression/extraction systems. DFL  is  pre-
  232.         customized for several popular archive systems. 
  233.  
  234.         The  only  difference  between  the  shareware  version  and  the 
  235.         registered version is that the shareware version has opening  and 
  236.         closing  registration  reminder  screens.
  237.  
  238.         1.2       System Requirements
  239.  
  240.         DFL.EXE will run on any PC XT/AT or compatible machine, using any 
  241.         80x86  processor chip, monochrome or color display,  under  MSDOS 
  242.         3.0+  in  about 400k of memory.  Additional memory is  needed  to 
  243.         interface with external archive systems.  For some, this is  only 
  244.         90k.  Others need 190k.  Check the documentation for the specific 
  245.         archive  programs you use.  DFL runs in about 540k of memory  (or 
  246.         less) with the ZIP, PAK, ZOO, LZH and ARC archive programs.
  247.                                                        Page 6
  248.  
  249.  
  250.         1.3       Technical Support
  251.  
  252.         As a DFL user, you may reach us in the following ways:
  253.  
  254.             1. Write:       W. S. Ataras Engineering
  255.                             40 Laughton Street
  256.                             Upper Marlboro, Md. 20772
  257.  
  258.             2. Voice mail:  1-301-249-1141 (East coast)
  259.                Voice mail:  1-408-648-3662 (West coast)
  260.  
  261.             3. BBS:         Ed's BBS 1-408-384-3658 for the current version.
  262.  
  263.                             Leave message to BILL ATARAS.
  264.                             Look for DFL*.*
  265.  
  266.             4. CompuServe:  William Ataras
  267.                             70322,1514
  268.                             IBM System\Util. Forum
  269.  
  270.         
  271.         1.4       Registration Information
  272.  
  273.         This  is the REGISTERED version of DFL.  You  will  automatically 
  274.         receive  any  new releases issued to correct bugs  identified  in 
  275.         this  version  at  no additional charge.  In  addition,  you  may 
  276.         register  for future versions at reduced rates  in order to  have 
  277.         the  most up-to-date features of DFL economically.
  278.  
  279.         DFL REGISTERED USERS RECEIVE:
  280.  
  281.              1. The latest version.
  282.              2. Any releases issued to correct bugs found in your version.
  283.              3. No shareware reminder screens.
  284.              4. Phone & modem support.
  285.              5. Printed manual.
  286.              6. A 30 day money-back satisfaction guarantee. 
  287.              7. Upgrade & follow-up notifications.
  288.  
  289.         We appreciate your registration, and hope that DFL is of continu-
  290.         ing  value  to you in the future.  If you discover bugs  in  DFL, 
  291.         please  tell us; if you are satisfied with DFL, please tell  your 
  292.         friends  and  associates, and pass on to them your  copy  of  the 
  293.         SHAREWARE version of DFL included on your distribution disk.
  294.                                                        Page 7
  295.  
  296.  
  297.         Unfortunately, in our society, it is necessary for us to let  you 
  298.         know  that  we  can only be responsible for what we  do.   W.  S. 
  299.         Ataras Engineering and its affiliated individuals hereby disclaim 
  300.         all  warranties  relating to this software,  whether  express  or 
  301.         implied,  including without limitation any implied warranties  of 
  302.         merchantability or fitness for a particular purpose.  We will not 
  303.         be liable for any special, incidental, consequential, indirect or 
  304.         similar damages due to loss of data or any other reason, even  if 
  305.         we  or an agent of W. S. Ataras Engineering has been  advised  of 
  306.         the possibility of such damages.  In no event shall our liability 
  307.         for any damages ever exceed the price paid for the license to use 
  308.         software, regardless of the form of the claim.  The person  using 
  309.         the software bears all risk as to the quality and performance  of 
  310.         the software.
  311.  
  312.         
  313.         1.5       Software License
  314.  
  315.         The software license agreement is shown below.
  316.  
  317.         DFL (tm) Duplicate File Locator Version 3.11
  318.         Copyright 1991, W. S. Ataras Engineering
  319.         All rights reserved.
  320.  
  321.         You are free to use DFL on any single computer, provided:
  322.          - no fee is charged for its use
  323.          - it is not modified in any way
  324.  
  325.         You  are free to distribute the SHAREWARE version of DFL on  your 
  326.         distribution disk provided
  327.          - no fee is charged for its use, copying or distribution
  328.          - it is not modified in any way
  329.  
  330.         If you want to charge a fee for distributing either the shareware 
  331.         or  registered  versions  of  DFL,  please  contact  W.S.  Ataras 
  332.         Engineering as described in this documentation. We are more  than 
  333.         happy  to make DFL accessible to everybody but must give  written 
  334.         permission first.
  335.  
  336.         The files on your distribute disk can be identified as follows:
  337.  
  338.          DFL311R.EXE   - Your personal registered copy of DFL
  339.          DFL.SAV       - The default configuration file
  340.          DFL.DOC       - This file providing the manual for DFL.
  341.          READREG.ME    - Read Me file with misc. notes
  342.          WHATSNEW      - List of new features.
  343.          VENDOR.DOC    - Information for vendors.
  344.          INSTALL.EXE   - DFL installation program.
  345.                                                        Page 8
  346.  
  347.  
  348.          DFL311.ZIP    - Your SHAREWARE copy of DFL and related files.
  349.                          This shareware distribution file contains
  350.           DFL311S.EXE  - The shareware executable program
  351.           DFL.SAV      - The default configuration file
  352.           DFL.DOC      - The manual
  353.           ORDER.DOC    - The program registration order form
  354.           DFLREAD.ME   - Read Me file with misc. notes
  355.           WHATSNEW     - List of new features.
  356.           VENDOR.DOC   - Information for vendors.
  357.           INSTALL.EXE  - DFL installation program.
  358.  
  359.  
  360.         2         Using DFL
  361.  
  362.         2.1       Command Line Options
  363.  
  364.         DFL  can be invoked from the DOS command line, or from  within  a 
  365.         batch  file,  These command line options allow you  to  configure 
  366.         and  run  DFL without any interaction.  They are  described  com-
  367.         pletely below.
  368.  
  369.         The  command line has the form: DFL [options], where each  option 
  370.         begins  with a slash and is followed by a space if there are  any 
  371.         subsequent options on the command line.
  372.  
  373.         The above options are used to set DFL's startup operating parame-
  374.         ters.  All of these parameters (except '/w=' - Working disk)  can 
  375.         be changed online via the functions described below.  For details 
  376.         on each of the online functions, please examine the corresponding 
  377.         context help as described below.
  378.  
  379.         
  380.         2.1.1     /?  List Options
  381.  
  382.         This option is used to obtain a complete screen of help  informa-
  383.         tion which describes all of the other command line options.   DFL 
  384.         will display the screen and return to the DOS command line.   You 
  385.         can then compose the command line which you need.
  386.  
  387.         EXAMPLE: DFL /?
  388.  
  389.         
  390.         2.1.2     /d  Drive List
  391.  
  392.         This  option is used to specify the drives to be scanned  in  the 
  393.         subsequent  processing.   If this option is not  used,  only  the 
  394.         current default drive will be processed.
  395.  
  396.         EXAMPLE: DFL /d=cd
  397.                                                        Page 9
  398.  
  399.  
  400.         2.1.3     /w  Working Disk
  401.  
  402.         This option is used to direct DFL to use a specific disk,  rather 
  403.         than the default disk, as the working disk.  The working disk  is 
  404.         used for virtual memory caching
  405.  
  406.            /w=  - Working disk. Default - Current.
  407.  
  408.         Specifies  an  alternate disk for virtual  memory  caching.  This 
  409.         option  overrides the DFLDISK environment variable  above.  DFL's 
  410.         performance  can be increased by caching to a faster device  such 
  411.         as  a  ramdisk.   DFL needs about 1meg of disk  space  for  every 
  412.         25,000  files.  Also, DFL extracts archived files to the  working 
  413.         disk  for  the View and Comparison functions.  The  working  disk 
  414.         should  have enough free space to hold any two archived files  as 
  415.         well as the virtual memory  itself.
  416.         At  startup, the root directory of the working disk  is  searched 
  417.         before the path for the external archive programs (defined  under 
  418.         'Archive  Laws') and file compare program (defined under  'FC.EXE 
  419.         Laws').   You can greatly enhance archive processing by  insuring 
  420.         that  the desired archive programs are in the working  disk  root 
  421.         directory prior to running DFL.
  422.  
  423.          EXAMPLE: DFL /lw=d
  424.  
  425.         
  426.         2.1.4     /f  Filename Mask
  427.  
  428.         This option is used to select the files which participate in  the 
  429.         file  data  acquisition process.  DFL begins  its  processing  by 
  430.         forming  a list of all files, on all of the scanned disks,  which 
  431.         match  the file name mask.  Once this list is built  internal  to 
  432.         DFL, it will begin to look for duplicates by name or content.  If 
  433.         one or more of the archive file processing functions are  active, 
  434.         DFL  will include in the file data list any matching files  found 
  435.         within the archives.
  436.  
  437.            /f=[Scan Mask]
  438.  
  439.         The  default  file name mask is *.*.  In the example  below,  DFL 
  440.         will acquire data only on C-language source files.
  441.  
  442.         EXAMPLE: DFL /f=*.c
  443.                                                        Page 10
  444.  
  445.  
  446.         2.1.5     /m  Scan Mode
  447.  
  448.         This  option is used to set the duplicate search mode.   If  this 
  449.         option is not used, DFL will default to the name mode.
  450.  
  451.            /m=[Scan Mode]
  452.         If  this option is not used, DFL will default to Name mode.   The 
  453.         list of valid options is:
  454.  
  455.             Mode        Parameter               Comment
  456.             -------------------------------------------------------
  457.             Name       /m=name           Find equal file names
  458.             Length     /m=length         Find equal file lengths
  459.             FastAlias  /m=fastalias      Find equal file CRCs. Very fast.
  460.             FullAlias  /m=fullalias      Find equal file contents.
  461.             Dos Path   /m=path           Find executables on the path
  462.             Name 1-11  /m=n1...n11       Find 1st 'n' equal name letters
  463.  
  464.         EXAMPLE: DFL /m=n4
  465.  
  466.         2.1.6     /l  List Output File & Auto Mode
  467.  
  468.         This option is used to identify a file name to contain the dupli-
  469.         cate  information.  DFL will process automatically based  on  the 
  470.         options given, and defaults for the options not given.  Then, the 
  471.         contents  of the duplicate window will be written to  this  file.  
  472.  
  473.         DFL will exit to DOS when processing is complete.
  474.  
  475.            /l(a/w)=[List file]
  476.  
  477.         If the option letter is followed by "a", the new information will 
  478.         be  appended to the existing file;  if the option letter is  fol-
  479.         lowed  by  "w", the file, if it exists, will  have  its  contents 
  480.         discarded before writing the dup info.  The default is "w".
  481.  
  482.         EXAMPLE: DFL /lw=LIST    write dup info to file "LIST"
  483.                  DFL /la=LIST    append new dup data to the end of "LIST"
  484.  
  485.  
  486.         2.1.7    /mono   Use monochrome colors
  487.  
  488.         DFL attempts to auto-detect the type of display card/monitor  you 
  489.         are  using. ON monochrome cards, DFL uses monochrome  colors.  On 
  490.         color  cards, colors are used. There may be a chance that DFL  is 
  491.         unable  to  detect  your hardware and adjust  its  colors  to  be 
  492.         readable.  For example, if you can read some of the  screen,  but 
  493.         not  all,  try the /mono option. This will use  black  and  white 
  494.         colors that should be visible on any screen.
  495.                                                        Page 11
  496.  
  497.  
  498.         2.2       Environment Variables
  499.  
  500.         There  are  two DOS environment variables which can  be  used  as 
  501.         described below.
  502.  
  503.         
  504.         2.2.1     DFLDISK = Working Disk
  505.  
  506.         Use "SET DFLDISK=[drive letter]" in your AUTOEXEC.BAT or from the 
  507.         DOS  command line to define a working disk for DFL.  The  working 
  508.         disk is used for virtual memory caching.  The '/w=' command- line 
  509.         option  described below overrides this.  The default is the  cur-
  510.         rent disk.
  511.  
  512.         DFL's performance can be increased by caching to a faster  device 
  513.         such as a ramdisk.  DFL needs about 1 MB of disk space for  every 
  514.         25,000  files.  Also, DFL extracts archived files to the  working 
  515.         disk  for  the View and Comparison functions.  The  working  disk 
  516.         should  have enough free space to hold any two archived files  as 
  517.         well as the virtual memory files.
  518.  
  519.         At   startup, the root directory of the working disk is  searched 
  520.         before the path for the external archive programs (defined  under 
  521.         'Archive  Laws') and file compare program (defined under  'FC.EXE 
  522.         Laws').   You can greatly enhance archive processing by  insuring 
  523.         that  the desired archive programs are in the working  disk  root 
  524.         directory prior to running DFL.
  525.  
  526.         
  527.         2.2.2     DFLCFG = Save File Directory
  528.  
  529.         Use "SET DFLCFG=[directory spec] in your AUTOEXEC.BAT or from the 
  530.         DOS  command  line  to define the directory  which  contains  the 
  531.         DFL.SAV  file. DFL uses the following priorities  in  determining 
  532.         this directory:
  533.  
  534.             1. Check the DFLCFG environment variable.
  535.             2. Search the current directory for DFL.SAV.
  536.             3. Search the path for DFL.SAV.
  537.             4. Use the DFL.EXE host directory.
  538.  
  539.         DFl.SAV  is used to store the Archive Definitions and other  mis-
  540.         cellaneous  data.  If it does not already exist in the  directory 
  541.         determined above, it will be created and initialized.
  542.  
  543.         The  basic  idea  is that once you tuck away  DFL.EXE  &  DFL.SAV 
  544.         somewhere  on your path, you won't have to worry about them  any-
  545.         more.
  546.                                                        Page 12
  547.  
  548.  
  549.         2.3       The Interactive Interface
  550.  
  551.         When  DFL initializes, you will see a menu bar at the top of  the 
  552.         screen, three status windows below the menu bar and a big  window 
  553.         at  the bottom of the screen.  The status windows  are  described 
  554.         below.   The large window at the bottom is the Duplicate  Window. 
  555.         That is where the list of duplicate files will appear.
  556.  
  557.         You can interface with DFL in either of two windows.  DFL  begins 
  558.         in the first window, the pull down menu window.  While in a menu, 
  559.         use  the Up and Down arrow keys to move the menu cursor bar.  You 
  560.         may  activate  the function under the bar  by  striking  <ENTER>.  
  561.         Context sensitive help can also be obtained by striking <F1>.  To 
  562.         jump  to another menu, either strike its hot key or use the  Left 
  563.         and  Right arrow keys to cycle around.  All functions  and  menus 
  564.         can be accessed independently with their corresponding hot keys.
  565.  
  566.         The  second window is the Duplicate Window.  To jump between  the 
  567.         Duplicate  Window  and  the menu window, strike  the  <ESC>  key.  
  568.         While in the Duplicate Window, use the Up and Down arrow keys  to 
  569.         move  the cursor bar through the file list.  Your relative  posi-
  570.         tion  in the list will be indicated by a small horizontal bar  on 
  571.         the  left border.  If the path for a file is too wide to  fit  in 
  572.         the window, it may be scrolled by using the Left and Right  arrow 
  573.         keys. 
  574.  
  575.         Remember  that  you can activate any function with its  hot  key.  
  576.         You need not use the menus.
  577.  
  578.         Once  you master the hot keys, you'll find it easy  to  configure 
  579.         DFL, build the list of duplicates, and examine the results.
  580.  
  581.         
  582.         2.3.1     Menu or Non-menu Access
  583.  
  584.         DFL  has two primary windows: the Menu window and  the  Duplicate 
  585.         List  window.   The Menu window is used to enter  commands  under 
  586.         normal circumstances.  It also offers context sensitive help  for 
  587.         each menu function before the functions are selected.
  588.  
  589.         You  use the ESC key to switch between windows.  However, as  you 
  590.         gain experience with DFL, you may want to remain in the duplicate 
  591.         list  window and execute the functions directly.  The  designated 
  592.         keys to do this are described below; they are also listed in  the 
  593.         pull-down windows.
  594.                                                        Page 13
  595.  
  596.  
  597.         2.3.2     Help System
  598.  
  599.         DFL is equipped with a complete, on-line, context sensitive  help 
  600.         system.   At  virtually any time, you can press the  F1  key  and 
  601.         obtain specific help about the menu choice which is  highlighted.  
  602.         Press the ESCAPE key to return to the program.
  603.  
  604.         If  you need more help after looking at the context help  window, 
  605.         press F1 again to obtain access to the entire help text.  You can 
  606.         then scroll through the help information using the cursor control 
  607.         keys.   Press  ESCAPE from this help window and  you  will  again 
  608.         return to the menu system.
  609.  
  610.         Help is also available when you are viewing a file.  Again, press 
  611.         F1  to access help information specifically written to  give  you 
  612.         assistance about the file viewing functions available.
  613.  
  614.         
  615.         2.3.3     Scan Status Window
  616.  
  617.         You  will find the following items in the upper three windows  on 
  618.         the  main screen.  These windows report basic  statistics  deter-
  619.         mined while DFL is running.
  620.  
  621.           Directories - Total directories scanned.
  622.           Files       - Total files scanned.
  623.           Duplicates  - Total duplicate files found.
  624.           Dupe Bytes  - Total bytes in the duplicate files.
  625.  
  626.         2.3.4     Scan Style Window
  627.  
  628.           Mask        - Current scan mask.
  629.           Mode        - Current scan mode (Alias/Name/Length/Name 1-11 ).
  630.  
  631.         
  632.         2.3.5     Disk Status Window
  633.  
  634.           Disk        - Current drive being displayed.
  635.           Disk total  - Total bytes on current drive.
  636.           Disk free   - Total free bytes on current drive.
  637.           Disk dups   - Total bytes in duplicate files on current drive.
  638.                                                        Page 14
  639.  
  640.  
  641.         2.3.6     Duplicate List Window (Non-menu mode)
  642.  
  643.         After  the list of duplicate files has been generated,  the  list 
  644.         appears  in the duplicate list window.  You can move between  the 
  645.         duplicate list and menu windows by simply pressing the ESCAPE key 
  646.         whenever DFL is waiting for a key-stroke.
  647.  
  648.         All of the cursor keys are active while you are in the  duplicate 
  649.         list  window.   The horizontal motion cursor keys will  move  you 
  650.         from one entry to another in the main menu bar at the top of  the 
  651.         screen.   The vertical cursor motion keys will move  you  through 
  652.         the  sub-menu items for each main function.  Select any  function 
  653.         by pressing the ENTER key.
  654.  
  655.         2.4       Running DFL
  656.  
  657.         DFL  can  be run in three different ways: from  the  DOS  command 
  658.         line, from a batch file, and interactively using the menu system.
  659.  
  660.         
  661.         2.4.1     Unattended
  662.  
  663.         You can run DFL unattended by installing the DFL command line you 
  664.         want  to use, making sure to include the list file  option  (/l).  
  665.         This option directs DFL process using either the default  parame-
  666.         ters or the command line parameters, to write the duplicate  list 
  667.         to a file automatically and then return to DOS.
  668.  
  669.         
  670.         2.4.2     A Fresh Start
  671.  
  672.         If for any reason you wish to rebuild the list of files, you  can 
  673.         activate the "BEGIN SCAN" function in the "RUN" menu.  Any exist-
  674.         ing  list will be discarded.  Normally, this is not needed  since 
  675.         DFL  maintains a list of all files found internally.   But,  suit 
  676.         yourself.
  677.  
  678.         2.4.3     Resorting
  679.  
  680.         Before DFL can locate the duplicate files, it must first build  a 
  681.         list  of all of the files on the disk or disks to  be  processed.  
  682.         If enabled, this will also include files stored in archive files.  
  683.         After the list is built, DFL will sort the list according to  the 
  684.         mode selected: alphabetically if NAME mode has been selected,  or 
  685.         by file length if ALIAS mode has been selected.
  686.  
  687.         After  using the list as it was originally prepared  and  sorted, 
  688.         you  may  change the mode and resort by commanding DFL  to  start 
  689.         using  the "RESORT" option in the "RUN" menu.  In this case,  DFL 
  690.         will use the previously accumulated list of files.
  691.                                                        Page 15
  692.  
  693.  
  694.         2.5       Duplicate File Search Modes
  695.  
  696.         There  are six  duplicate search modes available.  They  are  de-
  697.         scribed in the next four paragraphs.
  698.  
  699.         
  700.         2.5.1     Name Mode
  701.  
  702.         In  NAME mode, DFL will look for files which have the same  name.  
  703.         If  your hard disk is like mine, you may have several  copies  of 
  704.         COMMAND.COM, for example, in various directories.  By building  a 
  705.         list of files and sorting the list alphabetically, files with the 
  706.         same  name will be adjacent in the list.  DFL will  then  display 
  707.         groups  of two or more files with the same name in the  duplicate 
  708.         window.  A blank line will separate each adjacent group.
  709.  
  710.         The  files  in  each group are selected based solely  on  a  name 
  711.         match.  This  means that, although the names are  the  same,  the 
  712.         contents  may  not be. For example, you will  probably  locate  a 
  713.         large  number of "README" files. Practically every program I  use 
  714.         has one.
  715.  
  716.         To see if the contents are the same, DFL gives you the option  of 
  717.         comparing the contents of any two files.  The use of this  option 
  718.         is described in detail elsewhere in this manual.
  719.  
  720.         
  721.         2.5.2     FastAlias Mode
  722.  
  723.         In  FastAlias mode, DFL attempts to locate files  with  duplicate 
  724.         contents using 32 bit CRCs. That is, files with equal lengths and 
  725.         equal CRCs are assumed to be duplicate. The chances of two  files 
  726.         meeting  this criteria and having different contents are  on  the 
  727.         order  of  1  in  millions.  Under  this  mode,  files  that  are 
  728.         determined to be duplicate are PRACTICALLY GUARANTEED to actually 
  729.         be duplicate. The benefits of this mode are:
  730.  
  731.         1. The  files  are  never actually compared  byte-by-byte  as  in 
  732.            FullAlias mode (described below). This dramatically  decreases 
  733.            the search time and disk activity.
  734.         2. Very   time-consuming  recursive  situations  that  occur   in 
  735.            previous versions of DFL are avoided.
  736.         3. DFL  uses the same 32 bit CRC that is used in ZIP files.  This 
  737.            means  that  doing  a FastAlias search through  ZIP  files  is 
  738.            incredibly  fast  because  CRCs for  the  archived  files  are 
  739.            already  computed and files never need to be extracted  for  a 
  740.            byte-by-byte comparison.
  741.                                                        Page 16
  742.  
  743.  
  744.         2.5.3     FullAlias Mode.
  745.  
  746.         In  FullAlias mode, DFL attempts to locate files  with  duplicate 
  747.         contents  by performing byte-by-byte comparisons of the  contents 
  748.         of  equal  length & CRC files. Under this mode,  files  that  are 
  749.         determined  to  be  duplicate  are  GUARANTEED  to  actually   be 
  750.         duplicate.  This  mode  is  essentially  the  same  as  FastAlias 
  751.         (described  above)  with the addition that the  contents  of  two 
  752.         files are compared after the length and CRC are determined to  be 
  753.         equal. The benefits of this mode are:
  754.  
  755.         1. Because of the CRC layer, DFL knows ahead of time which  files 
  756.            actually  need  to  be  compared  and  thus,  performs   fewer 
  757.            comparisons.  Previous  versions of DFL took  the  John  Wayne 
  758.            approach  and compared all equal length files. Users of  older 
  759.            versions of DFL should notice a dramatic speed improvement  in 
  760.            their Alias searches.
  761.  
  762.         2. Unlike   the   1-in-millions  possibility   under   FastAlias, 
  763.            duplicate files found by FullAlias are GUARANTEED duplicate.
  764.  
  765.         2.5.4     Length Mode
  766.  
  767.         In  length mode, DFL will look for files having the same  length.  
  768.         The  files are not checked automatically to see if they have  the 
  769.         same  contents.  You must use the file compare function on  indi-
  770.         vidual pairs of files manually to check for matching contents.
  771.  
  772.         
  773.         2.5.5     Partial Name Mode
  774.  
  775.         In the partial name mode, files are added to the duplicate window 
  776.         if  the  first few characters of their file names are  the  same.  
  777.         From  the mode select menu, you can set the length of the  number 
  778.         of required matching characters to any number from 1 to 11.   For 
  779.         example,  if  this mode is run with a three character  match  re-
  780.         quirement, the files "DFL261.EXE" and "DFL.ZIP" will be shown  as 
  781.         duplicates.  Obviously, the file comparison function must be used 
  782.         to check for duplicate contents.
  783.  
  784.         2.5.6     Dos Path Mode
  785.  
  786.         Selecting  this mode will cause DFL to scan your Path  (see  your 
  787.         dos  manual  for  a  description  of  the  Path)  for   duplicate 
  788.         executables.  The selected disks and scan mask are ignored.  Only 
  789.         files  matching *.EXE, *.COM and *.BAT on the Path are  examined. 
  790.         As  an  example,  DFL.EXE,  DFL.COM  and  DFL.BAT  are  duplicate 
  791.         executables  that,  if in the Path, can  cause  some  frustrating 
  792.         confusion.
  793.                                                        Page 17
  794.  
  795.  
  796.         2.6       The Filename Mask
  797.  
  798.         A file name mask can be used to limit the search to files  match-
  799.         ing the given mask.  For example, you can process only executable 
  800.         files  by using the mask "*.EXE" or "*.COM".
  801.  
  802.         
  803.         2.7       The Drive Scan List
  804.  
  805.         DFL  can  process any number of disk drives.  Using  the  "SELECT 
  806.         DISKS"  function in the "SETUP" menu, you can turn on or off  any 
  807.         combination  of the available drives.  All drives turned on  will 
  808.         be processed in a single processing run.
  809.  
  810.         2.8       Saving the Duplicate List
  811.  
  812.         After  DFL has generated the list of duplicates, you may want  to 
  813.         postpone  your  review of the list until a later time.   DFL  can 
  814.         help  by  allowing you to write the list to an ASCII  text  file.  
  815.         You  can then print the file, or edit it with any editor, as  you 
  816.         see fit. Use function F9.
  817.  
  818.  
  819.         3         DFL Online Functions
  820.  
  821.         3.1       Overview
  822.  
  823.         When  you  operate DFL in the interactive mode, there  are  three 
  824.         active  windows, plus several status display  windows  available.  
  825.         These will all be discussed below.
  826.  
  827.         DFL has three active windows: the menu window, the duplicate list 
  828.         window,  and the file viewing window.  The menu window gives  you 
  829.         access  to all of the program functions using a system  of  pull-
  830.         down sub-menus.  The duplicate list window is used to display the 
  831.         groups  of duplicate files after your disk drives have been  ana-
  832.         lyzed.  And the file viewing window is used to view any file from 
  833.         the list in the duplicate window.
  834.  
  835.         
  836.         3.1.1     The Menu Window
  837.  
  838.         The  first window available is the MENU window.  In this  window, 
  839.         you  can  access most of the DFL functions.  The arrow  keys  are 
  840.         used to move from function to function, with the current function 
  841.         highlighted using reverse video.  The horizontal cursor keys move 
  842.         you from one primary function to another.  For the primary  func-
  843.         tion selected, the appropriate sub-menu will be displayed.
  844.                                                        Page 18
  845.  
  846.  
  847.         The  vertical cursor keys are used to move from one  sub-function 
  848.         to another.  For all of these functions, a context sensitive help 
  849.         window  can  be called up simply be pressing the  F1  key.   This 
  850.         window will explain the current function.
  851.  
  852.         You activate the current function by pressing the ENTER key.  DFL 
  853.         will go on to perform whatever function you have requested.   All 
  854.         of  the functions available in the menu window will be  described 
  855.         below.
  856.  
  857.         In  addition  to accessing functions using the cursor  and  ENTER 
  858.         key, DFL will also accept function commands directly at any time.  
  859.         Certain  keys will immediately activate corresponding  functions.  
  860.         These hot-keys are listed in the sub-windows and described  below 
  861.         as well.
  862.  
  863.         
  864.         3.1.2     The Duplicate Window
  865.  
  866.         The DUPLICATE window is used by DFL to present the list of dupli-
  867.         cate  files.   After  your disks have been  processed,  DFL  will 
  868.         display  all duplicates as separate groups in the duplicate  win-
  869.         dow.   Along  with each file name, you will see the path  to  the 
  870.         file, the size of the file, the date it was last written, and the 
  871.         time of the last write.
  872.  
  873.         Files  which  are contained in an archive of some  type  will  be 
  874.         marked by an asterisk.  The last file name in the path for such a 
  875.         file will have the normal archive suffix.  This will indicate the 
  876.         type  of  archive which contains the file.  For example,  if  the 
  877.         suffix is ".ZIP", then the file was found in an archive processed 
  878.         by the programs offered by PKWARE, Inc.
  879.  
  880.         You can scroll through the list of files in this window,  compare 
  881.         any  two  files, view any file, delete any single file,  tag  and 
  882.         delete any number of files, or write the list of duplicates to an 
  883.         output file for later processing.  How to perform these functions 
  884.         is described in various sections below.
  885.  
  886.         On the left vertical frame of this window, a small marker appears 
  887.         and  indicates your relative position in the full list of  dupli-
  888.         cates.  This marker moves from top to bottom as you scroll toward 
  889.         the  end of the list.  This helps you estimate where you  are  in 
  890.         the total list.
  891.                                                        Page 19
  892.  
  893.  
  894.         3.1.3     The File View Window
  895.  
  896.         The  file VIEW window allows you to view any file listed  in  the 
  897.         duplicate window.  Often, this will help you in deciding  whether 
  898.         or not to delete a file.  While you are in the duplicate  window, 
  899.         a single file is highlighted at any given time.  You can  immedi-
  900.         ately  view  the file by pressing the F10 key.  The  VIEW  window 
  901.         will  open and replace the duplicate window with the contents  of 
  902.         the selected file.
  903.  
  904.         You  can  scroll through the file, left and right,  up  or  down, 
  905.         using  the cursor control keys.  You can also move to the  begin-
  906.         ning  or  end  of the file by pressing the  HOME  and  END  keys.  
  907.         Naturally, a help window can be accessed using F1 to describe all 
  908.         of the active keys available.
  909.  
  910.         
  911.         3.2       Global Functions
  912.  
  913.         All  of  the functions available using the  cursor  movement  and 
  914.         ENTER  keys  can be accessed directly using the  global  function 
  915.         keys described below.  In general, most of these keys are  active 
  916.         only while you are in the MENU or DUPLICATE windows.
  917.  
  918.         
  919.         3.2.1     ESC    Menu & Non-menu Toggle
  920.  
  921.         The  ESCAPE  key provides a number of utility functions.   It  is 
  922.         used to toggle between the MENU and DUPLICATE windows.  When  you 
  923.         are  viewing  a  file or a help screen, the ESC key  is  used  to 
  924.         return to the prior MENU or DUPLICATE window.
  925.  
  926.         3.2.2     Alt-H  Help Menu
  927.  
  928.         You  can access context sensitive help at most times by  pressing 
  929.         the Alt-H key.  Immediately, a window will open with  information 
  930.         regarding the specific function you are considering.
  931.  
  932.         If  you press this key combination while in a  context  sensitive 
  933.         help  screen,  you  will move into the full  help  system.   From 
  934.         there, you can access all of the normal on-line help topics.
  935.  
  936.         Exit from either help screen by pressing the ESC key.
  937.                                                        Page 20
  938.  
  939.  
  940.         3.2.3     Alt-S  Setup Menu
  941.  
  942.         The setup menu is used to configure DFL for the specific process-
  943.         ing  run you are beginning, and can be accessed by  pressing  the 
  944.         Alt-S key.  You may also define the archive functions you want to 
  945.         include in the processing run.
  946.  
  947.         DFL  can access any of the popular archive programs by  executing 
  948.         the  proper external program.  It is your responsibility  to  ac-
  949.         quire your favorite programs and define for DFL the method needed 
  950.         to use the program.  By accessing your personal archive system in 
  951.         this way, DFL is not locked into any proprietary archive  system, 
  952.         and  you aren't either.  As these programs evolve, you need  only 
  953.         update the information in the DFL configuration file through  the 
  954.         setup menu.
  955.  
  956.         
  957.         3.2.4     Alt-R  Run Menu
  958.  
  959.         The  run menu is used to start a DFL processing run, and  can  be 
  960.         accessed by pressing the Alt-R key.  If you have already built  a 
  961.         list  of files, you can have DFL resort the list for a  different 
  962.         mode, and then build a new list of duplicates.  In this way,  you 
  963.         can  save some time when making a series of different  processing 
  964.         runs.
  965.  
  966.         
  967.         3.2.5     Alt-E  Exit Menu
  968.  
  969.         The exit menu is used to exit DFL and return to DOS, or to  shell 
  970.         to  DOS  temporarily, and can be accessed by pressing  the  Alt-E 
  971.         key.
  972.  
  973.         When you exit to DOS, all of the file list information accumulat-
  974.         ed by DFL is lost, unless you have written the duplicate list  to 
  975.         a file.
  976.  
  977.         You  can shell to DOS to do whatever miscellaneous functions  you 
  978.         desire.   Since  DFL uses a virtual memory system  to  store  its 
  979.         internal data tables, a lot of memory is available to execute DOS 
  980.         functions,  and  the file list information is not lost.   If  you 
  981.         have  shelled out to DOS, you can return to DFL by typing  "EXIT" 
  982.         at any DOS prompt.
  983.  
  984.         3.2.6     Alt-X  Exit DFL
  985.  
  986.         You  can go directly to the DFL exit function by pressing  Alt-X.  
  987.         DFL  will  request  confirmation of your desire  to  exit  before 
  988.         proceeding.
  989.                                                        Page 21
  990.  
  991.  
  992.         3.2.7     Home   Top of List
  993.  
  994.         In  the  duplicate window, you can move to the beginning  of  the 
  995.         list  by pressing the HOME key.  The position marker on the  left 
  996.         window frame will move to the top of the frame.
  997.  
  998.         In  the file view window, pressing the HOME key will move you  to 
  999.         the beginning of the file being viewed.
  1000.  
  1001.         
  1002.         3.2.8     End    Bottom of List
  1003.  
  1004.         In  the duplicate window, you can move to the bottom of the  list 
  1005.         by pressing the END key.  The position marker on the left  window 
  1006.         frame will move to the bottom of the frame.
  1007.  
  1008.         In  the file view window, pressing the END key will move  you  to 
  1009.         the end of the file being viewed.
  1010.  
  1011.         
  1012.         3.2.9     PgUp   Next Page in List
  1013.  
  1014.         In  the  duplicate  window, you can move up one  screen  full  of 
  1015.         duplicate files by pressing the PAGE UP key.
  1016.  
  1017.         In  the  file  view window, you can move up one  screen  of  file 
  1018.         information by pressing the PAGE UP key.
  1019.  
  1020.         
  1021.         3.2.10    PgDn   Previous Page in List
  1022.  
  1023.         In  the  duplicate window, you can move down one screen  full  of 
  1024.         duplicate files by pressing the PAGE DOWN key.
  1025.  
  1026.         In  the  file view window, you can move down one screen  of  file 
  1027.         information by pressing the PAGE DOWN key.
  1028.  
  1029.         
  1030.         3.2.11    F1     Call for Help
  1031.  
  1032.         At  any  time,  you can obtain help about the  current  topic  by 
  1033.         pressing  the F1 key.  If you are already in a help  window,  you 
  1034.         will  move to the full DFL help window.  In this window, you  can 
  1035.         scroll through all of the help information available on-line.
  1036.                                                        Page 22
  1037.  
  1038.  
  1039.         3.2.12    SF1    Display Help Topics
  1040.  
  1041.         At any time, you can press the Alt-F1 and open a menu of DFL help 
  1042.         topics.  You can then scroll through this window using the cursor 
  1043.         keys,  and select a topic of interest by pressing the ENTER  key.  
  1044.         Another  window will then pop up giving information on the  topic 
  1045.         of  interest.  From any of these topic windows, you can  move  to 
  1046.         the  full  help  window by pressing F1, or return  to  the  topic 
  1047.         selection window by pressing ESC.
  1048.  
  1049.         
  1050.         3.2.13    F2     Drive Selection
  1051.  
  1052.         By  pressing  the  F2 key when in either the  duplicate  or  menu 
  1053.         windows, you will move to a window which will allow you to select 
  1054.         the disk drives which will participate in the file search.
  1055.  
  1056.         DFL defaults to the current drive.  To select a  different  drive  
  1057.         or multiple drives, use this option.  You will be presented  with  
  1058.         a  window  containing  a list of the  available  drives.   Simply 
  1059.         position  the cursor bar over any drive letter and toggle  it  to 
  1060.         'Yes'  or 'No' using the space bar.  When DFL begins  processing, 
  1061.         the drives that were toggled to 'Yes' will be scanned.
  1062.  
  1063.         
  1064.         3.2.14    F3     Name Mask Selection
  1065.  
  1066.         By  pressing  the  F3 key when in either the  duplicate  or  menu 
  1067.         windows, you will move to a window which will allow you to define 
  1068.         the scan mask.
  1069.  
  1070.         The Scan Mask is used to determine which files DFL will  remember 
  1071.         while scanning the disk(s).  The standard DOS filespec  including 
  1072.         wildcards is accepted.
  1073.  
  1074.         For  example, using '*.*' as the mask will force DFL to  consider 
  1075.         EVERY  file during the scan.  Or, you may scan every file  begin-
  1076.         ning with 'A' by using 'A*.*'.
  1077.  
  1078.  
  1079.         3.2.15    F4     Scan Mode Selection
  1080.  
  1081.         By  pressing  the  F4 key when in either the  duplicate  or  menu 
  1082.         windows, you will move to a window which will allow you to define 
  1083.         the scan mode.
  1084.                                                        Page 23
  1085.  
  1086.  
  1087.         There  are four different scan modes available.  Like all  dupli-
  1088.         cate  file locator programs, you can use DFL to search for  files 
  1089.         with duplicate names.  In addition, DFL provides three additional 
  1090.         modes.  These are described below in more detail.
  1091.  
  1092.           Name     - DFL will find files with identical names.
  1093.           Length   - DFL will find files with equal lengths.
  1094.           Name1-11 - DFL will find files with the first N matching name
  1095.                      letters.
  1096.           Dos Path - DFL  will search the path for duplicate  executables 
  1097.                      like DFL.EXE, DFL.BAT & DFL.COM.
  1098.           Alias    - Also known as 'Content', an Alias scan can be time
  1099.                      consuming,  but very eye-opening.  This method  will
  1100.                      find files with identical contents, archived or not.
  1101.  
  1102.         
  1103.         3.2.16    F5     Begin Scan
  1104.  
  1105.         By pressing the F5 key when in either the duplicate or menu  win-
  1106.         dows, you will begin disk scanning using the mode and mask .
  1107.  
  1108.         
  1109.         3.2.17    SF5    Resort Scan
  1110.  
  1111.         By pressing the shift-F5 key when in either the duplicate or menu 
  1112.         windows, you will resorting the internal file list using the mode 
  1113.         and mask.
  1114.  
  1115.         
  1116.         3.2.18    F6     Select First File for Comparison
  1117.  
  1118.         By  pressing the F6 key while in the duplicate window,  you  will 
  1119.         identify  the  currently  highlighted file for use  in  the  file 
  1120.         comparison process.  The file line will begin blinking until some 
  1121.         other file is selected.
  1122.  
  1123.         If you press F6 while on a selected file line, you will de-select 
  1124.         the file, and it will stop blinking.
  1125.  
  1126.         
  1127.         3.2.19    F7     Start Binary File Comparison
  1128.  
  1129.         If  you press F7 while in the duplicate window, you will start  a 
  1130.         binary  file comparison process between the file currently  high-
  1131.         lighted  and the file selected with the F6 key.  This  comparison 
  1132.         will be performed as a binary, byte-by-byte comparison.  DFL will 
  1133.         report the results of the comparison in a status report window.  
  1134.                                                        Page 24
  1135.  
  1136.  
  1137.         3.2.20    F8     Delete One or More Files
  1138.  
  1139.         When  you  press F8 from within the duplicate  window,  you  will 
  1140.         delete  all tagged files.  If no files are tagged, then you  will 
  1141.         delete the file currently highlighted in the duplicate window.
  1142.  
  1143.         Any file or group of files, archived or not, can be.  Before  DFL 
  1144.         begins  the  delete  process, you will be asked  to  confirm  the 
  1145.         request.  If you answer no, or have no tagged files, you will  be 
  1146.         asked if you want to delete the file under the cursor bar.  Write 
  1147.         protected files are not deleted.
  1148.  
  1149.         Note that, when files are deleted, any sole survivors from  their 
  1150.         group are removed from the duplicate window but not deleted  from 
  1151.         disk.
  1152.  
  1153.  
  1154.         3.2.21    F9     Write Duplicate List
  1155.  
  1156.         When  you press F9 from the duplicate window, you  will  activate 
  1157.         the  DFL function which writes the list of duplicate files to  an 
  1158.         ASCII  file of your choice.  You will be prompted for  the  file-
  1159.         name.  This process may be aborted at any time by hitting the Esc 
  1160.         key.
  1161.  
  1162.         Use LPT1: or PRN to write directly to the printer.  The  pathname 
  1163.         field begins in column 51.  Paths which are longer than 30  char-
  1164.         acters may cause some 80 column printers to wrap lines.
  1165.  
  1166.         
  1167.         3.2.22    F10    View File Contents
  1168.  
  1169.         By pressing F10 from within the duplicate window, you will active 
  1170.         the file view function.  The view window will automatically open, 
  1171.         replacing the duplicate window.
  1172.  
  1173.         You may view any file marked by the cursor bar, archived or  not, 
  1174.         by selecting this function.  While in the file viewing subsystem, 
  1175.         use  the F1 key obtain a list of the various keystrokes  and  op-
  1176.         tions that are available.
  1177.  
  1178.         
  1179.         3.2.23    'F'    Start ASCII File Comparison
  1180.  
  1181.         By  pressing the "F" key while in the duplicate window, you  will 
  1182.         activate the ASCII file comparison routine.
  1183.  
  1184.         This  function causes DFL to run and display the results  of  the 
  1185.         external program FC.EXE Flaws in the Setup menu.  The default  is 
  1186.         FC.EXE,  the DOS file compare program.  However, you  may  define 
  1187.         your  own  provided the of the program goes to the  DOS  standard 
  1188.         output  device.   Examine the documentation for the  program  you 
  1189.         choose to use.
  1190.                                                        Page 25
  1191.  
  1192.  
  1193.         The  two  files may be of different  lengths.   Comparing  binary 
  1194.         files may produce a lengthy or useless list of differences.  This 
  1195.         function  is  normally used to compare the current version  of  a 
  1196.         file  and its backup copy.  If the files are different, the  com-
  1197.         pare  program will attempt to re-synchronize to similar lines  in 
  1198.         the  two files.  Because of the way this compare  program  works, 
  1199.         you  will be presented with a display of the differences  between 
  1200.         the two files.
  1201.  
  1202.         3.2.24    'T'    Toggle File Tag
  1203.  
  1204.         By  pressing this key while in the duplicate window, you can  tag 
  1205.         or  un-tag a file for future deletion.  The file currently  high-
  1206.         lighted  by  the cursor bar will be tagged or  untagged  with  an 
  1207.         arrow character appearing or disappearing on the left side of the 
  1208.         duplicate window.
  1209.  
  1210.         Later,  every  tagged file can be deleted  automatically  by  the 
  1211.         delete function.
  1212.  
  1213.         
  1214.         3.2.25    'U'    Untag all Files
  1215.  
  1216.         By  pressing this key while in the duplicate window,  the  delete 
  1217.         tags  will be cleared from all of the files which may  have  been 
  1218.         tagged.
  1219.  
  1220.         
  1221.         3.2.26    'S'    Shell to DOS
  1222.  
  1223.         This  function causes DFL to shell out to DOS.  DFL  will  remain 
  1224.         resident in about 320k of memory.  To return to DFL, simply enter 
  1225.         the command 'EXIT' at the DOS command line.
  1226.  
  1227.         
  1228.         3.2.27    ^C-Z   Display Drive Statistics
  1229.  
  1230.         Keys  Cntl-C through Cntl-Z select the status at the top  of  the 
  1231.         main screen to reflect the corresponding disk.
  1232.  
  1233.         If selected in the menu window, these keys will present you  with 
  1234.         the  list  of available disks.  From there, simply  position  the  
  1235.         cursor bar over a desired disk and hit the ENTER key.
  1236.  
  1237.         For  each  disk, you will see the total used  bytes,  total  free 
  1238.         bytes and total duplicate bytes.
  1239.                                                        Page 26
  1240.  
  1241.  
  1242.         4         DFL Archive Subsystem
  1243.  
  1244.         4.1       Overview
  1245.  
  1246.         The DFL archive handling system is a method which will allow  you 
  1247.         to  use DFL with your favorite archive processing programs.   For 
  1248.         example,  many  people choose ZIP, PAK, ZOO and  ARC  formats  to 
  1249.         maintain their archives.  In some cases, you may have several  of 
  1250.         these archive types present on your disks.
  1251.  
  1252.         DFL  can use any of these programs because we actually shell  out 
  1253.         invisibly whenever we need to access one of the archives. Because 
  1254.         we use your archive programs, DFL will always remain current with 
  1255.         the latest archive program technology.
  1256.  
  1257.         Also,  during the definition process, DFL will determine  if  the 
  1258.         archive file format can be accessed directly. This preferable  to 
  1259.         shelling to external programs because it is much faster.
  1260.  
  1261.         4.2       Defining an Archive
  1262.  
  1263.         To  use your choice of archive program, we provide a menu  driven 
  1264.         configuration process to gather the necessary information.   This 
  1265.         process is described below.
  1266.  
  1267.         Naturally, it is your responsibility to purchase or register your 
  1268.         particular  archive programs.  DFL will merely use  the  programs 
  1269.         you provide.  Just as you have registered for DFL, please  regis-
  1270.         ter the archive programs you use as well.
  1271.  
  1272.         
  1273.         4.2.1     Basic Parameters
  1274.  
  1275.         When  you  stop to think about it, performing the  DFL  functions 
  1276.         requires only four of the many archive program functions.   These 
  1277.         are:
  1278.  
  1279.           a) output a list of the files in the archive
  1280.           b) extract a file from the archive
  1281.           c) delete a file from the archive
  1282.           d) compress a file and add it to an archive
  1283.  
  1284.         4.2.1.1   Title
  1285.  
  1286.         This  is simply used as a reference.  Currently, it only  appears 
  1287.         in the list window where you previously selected this  definition 
  1288.         and  in the output duplicate list.  It can be any string of  your 
  1289.         choosing, preferably something meaningful.
  1290.                                                        Page 27
  1291.  
  1292.  
  1293.         4.2.1.2   Extension
  1294.  
  1295.         DFL  uses  the file name extension to identify  which  files  are 
  1296.         archives.   For  example, using 'ZIP' will cause  DFL  to  access 
  1297.         files  with  a  'ZIP' extension according  to  the  corresponding 
  1298.         definition.
  1299.  
  1300.         If the Archive Lister can obtain a file list, the archive will be 
  1301.         treated  as  a  pseudo-directory accessible as  outlined  by  the 
  1302.         definition.  Otherwise, DFL assumes its an ordinary file.
  1303.  
  1304.         
  1305.         4.2.1.3   Enable/Disable
  1306.  
  1307.         This  is  a Yes/No option allowing you to enable  or  disable  an 
  1308.         archive during the scan.  When an archive is disabled, files with 
  1309.         extensions that match the Archive Extension field will be treated 
  1310.         as regular files subject to the Scan Mask and Mode.
  1311.  
  1312.         Archives  can be quickly enabled or disabled in the Archive  List 
  1313.         window where the Definitions are selected.
  1314.  
  1315.         
  1316.         4.2.1.4   Screen Save
  1317.  
  1318.         This  is a Yes/No option telling DFL whether to restore the  dis-
  1319.         play  screen  after executing any of  the  corresponding  archive 
  1320.         programs.   It is not necessary for most programs.  We  use  this 
  1321.         function to compensate for any ill-behaved archive programs which 
  1322.         may be distributed.
  1323.  
  1324.         Start with Screen Save OFF.  Later in the definition process, DFL 
  1325.         will  attempt  to create and list a sample archive  to  help  you 
  1326.         describe the Lister Output format.  If the screen display becomes 
  1327.         damaged, this option should be set ON.
  1328.  
  1329.         
  1330.         4.2.2     Archive Programs
  1331.  
  1332.         As  stated  before,  we have tested DFL with  as  many  different 
  1333.         archive programs as we have been able to find.  The list includes 
  1334.         ZIP,  PAK,  LZH,  ZOO, and ARC.  With  the  proper  configuration 
  1335.         information, the versions of these programs which we were able to 
  1336.         obtain all worked perfectly.
  1337.  
  1338.         To enable you to modify your DFL configuration to match a differ-
  1339.         ent  program you may come across, or to adapt to future  versions 
  1340.         which may be released, DFL is equipped with a menu driven  system 
  1341.         to help.
  1342.                                                        Page 28
  1343.  
  1344.  
  1345.         Some of the archive programs we tested include numerous functions 
  1346.         for  your convenience.  DFL, however, requires only a very  basic 
  1347.         sub-set of the possible functions.
  1348.  
  1349.         Perhaps  the  greatest challenge you may have  with  your archive 
  1350.         files  is related to the use of encryption.  At least one of  the 
  1351.         archive  packages  offers file encryption for  security  reasons.  
  1352.         The password must be provided to access the archive file.   Since 
  1353.         the  password  must  be provided on the DOS  command  line  which 
  1354.         activates  the archive program, and this command line is part  of 
  1355.         the DFL configuration information, to use encryption, all of your 
  1356.         archives  must  have the same password, and the  password  itself 
  1357.         must  be included in the DFL configuration file.   Most  security 
  1358.         experts would object to this procedure.  We have no  alternatives 
  1359.         to offer at this time.
  1360.  
  1361.         
  1362.         4.2.2.1   Lister Program & Parameters
  1363.  
  1364.         This is the name of the program which DFL will run when  attempt-
  1365.         ing  to get the list of files contained in an archive.  DFL  will 
  1366.         search  the Dos Path for the given archive lister  program  name.  
  1367.         You need not enter the extension.  DFL tries 'COM' and 'EXE'.  To 
  1368.         obtain any help from the program, hit <F2>.
  1369.  
  1370.         At  startup,  DFL searches the DOS Path for this  program.   This 
  1371.         makes it easy to run DFL on other machines without worrying about 
  1372.         Paths and other related garbage.
  1373.  
  1374.         You will provide the name of your archive program and any command 
  1375.         line  options  needed  to obtain a list of the  files  within  an 
  1376.         archive.  In short, this function is the equivalent of "DIR"  for 
  1377.         and archive file.
  1378.  
  1379.         These  specify  the parameters for the  archive  lister  program.  
  1380.         These  are the same parameters that would normally be entered  on 
  1381.         the  command line.  Use '%1' to represent the  Archive  Filename.  
  1382.         To obtain any help from the program, press <F2>.
  1383.  
  1384.         For example, if you are using the ZIP system, the line
  1385.  
  1386.           PKUNZIP -v archive.zip' equates to DFL parameters:
  1387.  
  1388.           PKUNZIP(.exe) - the program
  1389.           -v %1         - the command line parameters
  1390.  
  1391.         Those  familiar  with the ZIP system will recognize this  as  the 
  1392.         command  which generates a list of the files within  an  archive.  
  1393.         DFL  will  redirect the program output to an internal  file  from 
  1394.         which the necessary information will be read.
  1395.                                                        Page 29
  1396.  
  1397.  
  1398.         4.2.2.2   Deleter Program & Parameters
  1399.  
  1400.         This is the name of the program which DFL will run when  attempt-
  1401.         ing to delete a file contained in an archive.  DFL search the Dos 
  1402.         Path  for a given name.  You need  not enter the extension.   DFL 
  1403.         tries 'COM' & 'EXE'.  To obtain any help from the program,  press 
  1404.         <F2>.
  1405.  
  1406.         At startup, DFL searches the Path for these programs.  This makes 
  1407.         it easy to run DFL on other machines without worrying about Paths 
  1408.         and other related garbage.
  1409.  
  1410.         This specifies the parameters for the Deleter program.  These are 
  1411.         the  same  items that would normally be entered  on  the  command 
  1412.         line.   Use '%1' to represent the Archive Filename.  '%2'  repre-
  1413.         sents  the archived file.  To obtain any help from  the  program, 
  1414.         press <F2>.
  1415.  
  1416.         For example, if you are using the ZIP system, the line
  1417.  
  1418.           PKZIP -d archive.zip equates to DFL parameters:
  1419.  
  1420.           PKZIP(.exe)   - the program
  1421.           -d %1 %2      - the command line parameters
  1422.  
  1423.         Those  familiar  with the ZIP system will recognize this  as  the 
  1424.         command which deletes a file from an archive.
  1425.  
  1426.         
  1427.         4.2.2.3   Extractor Program & Parameters
  1428.  
  1429.         This is the name of the program which DFL will run when  attempt-
  1430.         ing  to extract a file contained in an archive.  DFL will  search 
  1431.         the Dos Path for a given name.  You need not enter the extension.  
  1432.         DFL searches for both 'COM' & 'EXE' if necessary.  To obtain  any 
  1433.         help from the program, press <F2>.
  1434.  
  1435.         At startup, DFL searches the Path for these programs.  This makes 
  1436.         it easy to run DFL on other machines without worrying about Paths 
  1437.         and other related garbage.
  1438.  
  1439.         This  specifies the parameters for the Extractor program.   These 
  1440.         are the same items that would normally be entered on  the command 
  1441.         line.   Use '%1' to represent the Archive Filename.  '%2'  repre-
  1442.         sents  the archived file.  To obtain any help from  the  program, 
  1443.         press <F2>.
  1444.  
  1445.         For example, if you are using the ZIP system, the line
  1446.  
  1447.           PKUNZIP archive.zip    equates to DFL parameters:
  1448.  
  1449.           PKUNZIP(.exe)   - the program
  1450.           %1 %2           - the command line parameters
  1451.                                                        Page 30
  1452.  
  1453.  
  1454.         Those  familiar  with the ZIP system will recognize this  as  the 
  1455.         command which extracts a file from an archive.
  1456.  
  1457.         4.2.2.4   Compressor Program & Parameters
  1458.  
  1459.         This is the name of the program which DFL will run when  attempt-
  1460.         ing  to add a file to an archive.  DFL will search the  DOS  Path 
  1461.         for  a given name.  You need not enter the extension.  DFL  tries 
  1462.         both  'COM'  & 'EXE' if necessary.  To obtain any help  from  the 
  1463.         program, press <F2>.
  1464.  
  1465.         At startup, DFL searches the Path for these programs.  This makes 
  1466.         it easy to run DFL on other machines without worrying about Paths 
  1467.         and other related garbage.
  1468.  
  1469.         This specifies the parameters for the Compressor program.   These 
  1470.         are the same items that would normally be  entered on the command 
  1471.         line.   Use '%1' to represent the Archive Filename.  '%2'  repre-
  1472.         sents  the archived file.  To obtain any help from  the  program, 
  1473.         press <F2>.
  1474.  
  1475.         For example, if you are using the ZIP system, the line
  1476.  
  1477.           PKZIP archive.zip    equates to DFL parameters:
  1478.  
  1479.           PKZIP(.exe)     - the program
  1480.           -ex %1 %2       - the command line parameters
  1481.  
  1482.         Those  familiar  with the ZIP system will recognize this  as  the 
  1483.         command  which adds a file to an archive using  maximum  compres-
  1484.         sion.
  1485.  
  1486.  
  1487.         4.3.3     The Test Run
  1488.  
  1489.         When  each archive function is defined, DFL will request  a  test 
  1490.         run. Type 'y' or 'Y' to have DFL test each specific program as it 
  1491.         is defined.
  1492.  
  1493.         The following procedure is used by DFL automatically:
  1494.  
  1495.           1. Create a 32k dummy file.
  1496.           2. Add it to a dummy archive using the Compressor.
  1497.           3. List the dummy archive using the Lister.
  1498.           4. Extract the dummy file using the Extractor.
  1499.           5. Delete it from the archive using the Deleter.
  1500.  
  1501.         This  will allow you to confirm that DFL is properly  interfacing 
  1502.         with the external programs and make any necessary changes to  the 
  1503.         definition based on the results of the above tests.
  1504.  
  1505.         When  the  DFL configuration process is complete,  all  of  these 
  1506.         temporary files are deleted.
  1507.                                                        Page 31
  1508.  
  1509.  
  1510.         4.3.4     Archive Lister Output
  1511.  
  1512.         Perhaps  the most challenging aspect of configuring DFL  for  and 
  1513.         archive system are the steps needed to teach DFL how to read  the 
  1514.         output file generated by the archive lister program.
  1515.  
  1516.         If DFL recognizes the archive file format, you won't be requested 
  1517.         to continue here. The archives will be directly accessed.
  1518.  
  1519.         After  a sample run of the archive lister program, DFL will  dis-
  1520.         play the output file and have you position the cursor to  certain 
  1521.         specific  fields in a file data line.  DFL uses this  process  to 
  1522.         make  an  internal table which gives the position  in  each  line 
  1523.         where  the  various  fields begin, the  field  width,  and  other 
  1524.         properties.
  1525.  
  1526.         4.3.4.1   Name
  1527.  
  1528.         Use  the cursor left and right movement keys to locate the  first 
  1529.         column of the name of a file within the archive.
  1530.  
  1531.         DFL  will  ask  if the field is right  justified,  its  rightmost 
  1532.         character  will  always be in the same column.  If the  field  is 
  1533.         left justified, its leftmost character will always be in the same 
  1534.         column.
  1535.  
  1536.         Enter 'R' or 'r' if it is right justified.
  1537.         Enter 'L' or 'l' if it is left justified.
  1538.  
  1539.         4.3.4.2   Extension
  1540.  
  1541.         Some  archive lister programs output separate the file  name  and 
  1542.         extension.   In  this  case, DFL must treat the  extension  as  a 
  1543.         separate field and later concatenate it to the name.
  1544.  
  1545.         In  response to the DFL query, enter 'Y' or 'y' if there  are  no 
  1546.         spaces between the file name and extension.
  1547.  
  1548.  
  1549.         4.3.4.3   Length
  1550.  
  1551.         Define  the position and width of the file size within a line  of 
  1552.         the  sample  lister output file.  Follow  procedures  similar  to 
  1553.         those described for defining the file name field, and respond  to 
  1554.         the prompts given.
  1555.  
  1556.         
  1557.         4.3.4.4   Time
  1558.  
  1559.         Define  the position of the file time field within a line of  the 
  1560.         sample  lister output file.  Follow procedures similar  to  those 
  1561.         described above, and respond to the prompts given.
  1562.                                                        Page 32
  1563.  
  1564.  
  1565.         4.3.4.5   Date
  1566.  
  1567.         Define  the position of the file date field within a line of  the 
  1568.         sample  lister output file.  Follow procedures similar  to  those 
  1569.         described above, and respond to the prompts given.
  1570.  
  1571.         5         DFL File Viewing System
  1572.  
  1573.         5.1       Overview
  1574.  
  1575.         While  operating in the duplicate window, you have the option  of 
  1576.         viewing  any file.  The present viewing feature provides only  an 
  1577.         ASCII  display.  Thus, you may not be able to make sense  out  of 
  1578.         what  you  see  when viewing binary files such as  .EXE  or  .COM 
  1579.         files.
  1580.  
  1581.         Active the file viewer by pressing F10 while the desired file  is 
  1582.         highlighted in the duplicate window.
  1583.  
  1584.         The details of the file viewing feature are described below.
  1585.  
  1586.         
  1587.         5.2       Screen Layout
  1588.  
  1589.         When the viewer is activated, a new window is opened, filling the 
  1590.         screen with text from the file.  The top line gives the line  and 
  1591.         column  number of the character in the upper left corner  of  the 
  1592.         window, along with the path and name of the file.
  1593.  
  1594.         5.3       Viewer Commands
  1595.  
  1596.         The  viewer has a distinct set of command keys  identified.
  1597.  
  1598.         
  1599.         5.3.1     F1 - Quick Help
  1600.  
  1601.         The list of active keys and their assigned functions will  pop-up 
  1602.         in a window when you press the F1 key.
  1603.  
  1604.         
  1605.         5.3.2     Home & End
  1606.  
  1607.         Pressing the HOME key will move the display window to the  begin-
  1608.         ning of the file being viewed.
  1609.  
  1610.         Pressing  the END key will move the display window to the end  of 
  1611.         the file being viewed.
  1612.                                                        Page 33
  1613.  
  1614.  
  1615.         5.3.3     Page Keys
  1616.  
  1617.         The  PAGE UP and PAGE DOWN keys can be used to move  the  viewing 
  1618.         window up or down one page of text at a time.
  1619.         
  1620.         5.3.4     Arrow Keys
  1621.  
  1622.         The cursor control keys are used to scroll the viewing window  up 
  1623.         or  down  one line at a time, or left or right one  column  at  a 
  1624.         time.
  1625.  
  1626.         5.3.5     ^Home
  1627.  
  1628.         The Cntl-HOME key will immediately scroll the viewing window such 
  1629.         that  the  first  column of each file line is  in  the  left-most 
  1630.         column of the screen.
  1631.  
  1632.         5.3.6     ^PgUp & ^PgDn
  1633.  
  1634.         Using  Cntl-PAGE  UP and Cntl-PAGE DOWN will  cause  an  animated 
  1635.         scroll of the viewing window up or down a full page of text.
  1636.         
  1637.         5.3.7     ^Right & ^Left
  1638.  
  1639.         Pressing the Cntl-LEFT or Cntl-RIGHT keys will cause an  animated 
  1640.         scroll of the viewing window left or right 40 columns.
  1641.         
  1642.         5.3.8     'W' - Mask High Bits
  1643.  
  1644.         Since  some text files are written with 8 bit  ASCII  characters, 
  1645.         and  others  have the eighth bit set to zero, DFL gives  you  the 
  1646.         option of blanking out the eighth bit if the characters displayed 
  1647.         are confused. Press the W key to toggle the bit 8 mask on or off.
  1648.  
  1649.         5.3.9     'T' - Tab Toggle
  1650.  
  1651.         The readability of text files can sometimes be improved by chang-
  1652.         ing  the  number of columns assigned to each tab  character.   By 
  1653.         pressing  the T key, DFL will alternately select tab spacings  of 
  1654.         0, 4 or 8 columns.
  1655.  
  1656.         5.3.10    F2 - Print File
  1657.  
  1658.         You  may  print the file that is being viewed by hitting  the  F2 
  1659.         key.  This function attempts to copy the file to the PRN  device. 
  1660.         You  should  not  attempt to print a binary file  (one  that  has 
  1661.         unreadable  characters). Printing a binary file will  cause  your 
  1662.         printer to do unpredictable things.
  1663.                                                        Page 34
  1664.  
  1665.  
  1666.         6         Useful Topics
  1667.  
  1668.         6.1       Users' Questions and Answers
  1669.  
  1670.         This is a growing section which contains verbatim copies of email 
  1671.         correspondence between W.S. Ataras Engineering and users of  DFL. 
  1672.         If the conversation was verbal, it will appear here as a close to 
  1673.         the  actual content as memory permits. We welcome questions  from 
  1674.         anyone  even if they aren't registered users. Naturally, not  all 
  1675.         correspondence will be published here.
  1676.  
  1677.  
  1678.         Question:
  1679.  
  1680.         On  the  BBS system with over 1.5 gig of HD, I let  DFL  run  for 
  1681.         approx 4.5 hours and then the system deep ended (required a  cold 
  1682.         boot).  I  mistakenly started running DFL on a 286/10  and  might 
  1683.         have  been  successful if I had run on a 386 with more  ram.  The 
  1684.         problem  is due to intensive disk operations, the BBS comes to  a 
  1685.         virtual standstill while DFL is accessing the HDs (expected not a 
  1686.         complaint).
  1687.  
  1688.         Answer:
  1689.  
  1690.         I'm  assuming  you've  got  a  network  and  the  286/10  was   a 
  1691.         workstation  and you ran with archives ON in ALIAS mode.  All  of 
  1692.         this  applies  proportionally to non-network  installations  even 
  1693.         without  archives.  Just substitute references to  remote  server 
  1694.         disks   with  local  harddisks  and/or  ignore  archive   program 
  1695.         accesses.
  1696.  
  1697.         When   DFL   initializes   it  needs  to   create   2   temporary 
  1698.         subdirectories  and  5 temporary files. 4 of the files  hold  the 
  1699.         virtual  memory garbage and 1 is used to redirect the  output  of 
  1700.         the  archive programs. The 2 dirs are used to extract files  from 
  1701.         archives  for  comparison (alias mode) or  viewing.  DFL  creates 
  1702.         these files/dirs in the root directory of the WORKING DISK  which 
  1703.         defaults  to the disk you were currently logged to when  DFL  was 
  1704.         run. If this disk was remote on the server, then, particularly in 
  1705.         alias  mode, extremely heavy network traffic will result and  any 
  1706.         other  machine using that disk will degrade. Also, each time  DFL 
  1707.         extracts  an  archived  file,  it  must  load  and  execute   the 
  1708.         corresponding archive program (pkunzip.exe etc.). At startup, the 
  1709.         path  is searched for these. If they also reside on the  server's 
  1710.         disk, FURTHER network degradation will result. Here would be  the 
  1711.         scenario:
  1712.  
  1713.           1. Two archived files must be compared for alias dupes.
  1714.           2. Both archives are on the server.
  1715.           3. The archive extractor (assume unzip.exe) is on the server.
  1716.           4. The server is also the working disk.
  1717.                                                        Page 35
  1718.  
  1719.  
  1720.           DFL reads unzip.exe from the server.
  1721.           Unzip.exe reads archive 1 from the server.
  1722.           Unzip.exe writes archived file 1 to the server.
  1723.           DFL reads unzip.exe from the server.
  1724.           Unzip.exe reads archive 2 from the server.
  1725.           Unzip.exe writes archived file 2 to the server.
  1726.           DFL  begins reading both newly extracted files from the  server 
  1727.           to compare.
  1728.           DFL deletes both extracted files from the server.
  1729.  
  1730.         This  will happen perhaps thousands of times for a big disk  with 
  1731.         lots  of archives and doesn't include the scan phase  which,  for 
  1732.         each  archive,  runs unzip.exe from the server  which  reads  the 
  1733.         archive  on the server whose output is redirected to a  temporary 
  1734.         file  on the server which is then scanned and interpreted by  DFL 
  1735.         which  then  may tweak the virtual memory files  on  the  server. 
  1736.         Whew.
  1737.  
  1738.         DFL does, however, let you specify a different working disk using 
  1739.         the  environment variable DFLDISK=C or the command line  argument 
  1740.         /w=c  or  starting  DFL while logged to a  different  disk.  When 
  1741.         running on a workstation, consider the following:
  1742.  
  1743.         If the workstation has a local physical harddisk -
  1744.           Use it as the working disk.
  1745.           Try to setup a cache for it of about 1 meg.
  1746.  
  1747.         If the workstation doesn't have a local physical harddisk -
  1748.           Setup  a RAMDRIVE (fastest option) big enough to hold  the  two 
  1749.           largest  equal  length archived files plus the  virtual  memory 
  1750.           files  (at about 1meg per 20,000 files). Don't lose sleep  over 
  1751.           the  two largest archived files bit. DFL won't crash  if  there 
  1752.           isn't  enough space for the archiver to extract  files  (unless 
  1753.           the archiver crashes). Make a guess.
  1754.  
  1755.         Copy the archive programs that DFL will use (pkunzip.exe etc.) to 
  1756.         the  ROOT DIRECTORY of the working disk. DFL looks  there  before 
  1757.         the path when running external programs.
  1758.  
  1759.         With  that  setup, everything from  the  aforementioned  scenario 
  1760.         would  be  eliminated except for reading archives on  the  server 
  1761.         disk. DFL would access the local device for all other actions  at 
  1762.         full  blast.  The speed of operation and relief  to  the  network 
  1763.         would improve an order of magnitude, especially with the ramdrive 
  1764.         method.
  1765.                                                        Page 36
  1766.  
  1767.  
  1768.         Question:
  1769.  
  1770.         Other  than  the  ASCII file that you have allowed  the  user  to 
  1771.         create  showing  the  dups, apparently a complete  rerun  of  the 
  1772.         entire scan has to be performed to "restart" the operation. I had 
  1773.         thought  that you were creating a database file that would  allow 
  1774.         the  "rescan"  to be restarted and only check  "new"  or  changed 
  1775.         files.
  1776.  
  1777.         Answer:
  1778.  
  1779.         That's  true. DFL currently has no way of saving and restoring  a 
  1780.         session. That functionality will be released in the near future.
  1781.  
  1782.         We  haven't  seen a high demand for systems like DFL  which  work 
  1783.         from  a 'history' database because the disks would still need  to 
  1784.         be   scanned  every  time  to  verify  the   database   contents. 
  1785.         Effectively, the database needs to be re-created each time DFl is 
  1786.         run.  There  may be some time savings in that as  the  disks  are 
  1787.         scanned,  certain  actions for files which are  'already  in  the 
  1788.         database'  would  not need to happen. But then, the  overhead  of 
  1789.         determining if a file is 'already in the database' would probably 
  1790.         outweigh  the other gains. As you can see, we have  devoted  some 
  1791.         thought along those lines. If you have any further ideas,  please 
  1792.         let me know. The subject is by no means closed.
  1793.  
  1794.         If  "rescan"  refers to the Resort option under the run  menu  it 
  1795.         works as follows:
  1796.  
  1797.         DFL  scan the selected disks according to the Scan Mask to  build 
  1798.         the  base filelist. It then processes that list according to  the 
  1799.         Scan  Mode to produce the duplicate list. Resort basically  skips 
  1800.         the  scan  phase  and re-processes  the  existing  base  filelist 
  1801.         according  to  the Scan Mode (which has probably  been  changed). 
  1802.         This  saves whatever time and disk activity the scan phase  would 
  1803.         have  needed  (it  can  be alot on a  big  system  with  archives 
  1804.         enabled).  The idea is, during one session, scan your disks  once 
  1805.         for  the first mode search, then search for duplicates  by  other 
  1806.         modes using resort.
  1807.  
  1808.  
  1809.         Question:
  1810.  
  1811.         I  reran the DFL on my 40 Meg 386/20 notebook, and the scan  took 
  1812.         approximately 1 hour. The results showed about 13 Meg of dups  (I 
  1813.         ran  in ALIAS mode doing the compare by size. After deleting  the 
  1814.         dups  that I did not want, I had a few hundred K of dups  (I  zip 
  1815.         some  of  the work files that I use to save disk space)  but  DFL 
  1816.         showed  over 11 Meg of dups. I could find no reason for the  very 
  1817.         high  DUP count. When I tried to goto a different scan,  thinking 
  1818.         that the scan would take place on the nonexistent database  file, 
  1819.         I lost all information that I had.
  1820.                                                        Page 37
  1821.  
  1822.  
  1823.         Answer:
  1824.  
  1825.         Do you mean this happened?-
  1826.  
  1827.         1. Scanned by alias mode. Saw 13 megs of dupes.
  1828.         2. Tagged and deleted a chunk of files.
  1829.         3. Estimated there were a few hundred K of dupes left.
  1830.         4. DFL indicated 11 megs of dupes.
  1831.  
  1832.         Were there dupes in archives ? How did you determine there were a 
  1833.         few  hundred K of dupes ? As discussed under item 2, the  current 
  1834.         filelist  is  lost  when you begin a new  scan  (unless  you  use 
  1835.         Resort).  Note that the UNCOMPRESSED size of an archived file  is 
  1836.         added  to the total duplicate byte count while the disk space  it 
  1837.         occupies may be far less.
  1838.  
  1839.         Question:
  1840.  
  1841.         When  the scan initially starts, a time remaining is shown,  this 
  1842.         time is apparently based on the size of the archive, or directory 
  1843.         that is currently being tested. The time would start slow and  go 
  1844.         up and down at random (random to me I am sure it would make sense 
  1845.         to  you).  The time is not accurate until the  final  stage  (the 
  1846.         actual comparison of same sized files.
  1847.  
  1848.         Answer:
  1849.  
  1850.         This  is  true.  The  time remaining is  very  hard  to  estimate 
  1851.         accurately during an alias scan. It is a proportion of the number 
  1852.         of  bytes  in files currently processed over the total  bytes  in 
  1853.         files  that need to be processed and the total time expired  over 
  1854.         the total time that will expire. As an example, by comparing  the 
  1855.         first  10 bytes of 2 100k files, DFL may determine that they  are 
  1856.         NOT duplicates, whereas the next 2 100k files may have every byte 
  1857.         compared  to determine they ARE duplicates. There is not  way  to 
  1858.         anticipate  the  fact  that  2 huge equal  length  files  can  be 
  1859.         instantly  found  'not duplicate'. And becomes  more  complicated 
  1860.         when archives are enabled. This throws off the other half of  the 
  1861.         proportion, time remaining. We have considered implementing  some 
  1862.         form of artificial intelligence by maintaining various statistics 
  1863.         and  probabilities for the hardware DFL is running on.  This  may 
  1864.         facilitate better time estimates the more DFL is used on a  given 
  1865.         machine.  In fact, we'll probably be incorporating such a  scheme 
  1866.         in the future, but to tell the truth, other more pressing  issues 
  1867.         have needed attention.
  1868.                                                        Page 38
  1869.  
  1870.  
  1871.         6.2      DFL Temporary Files & Directories
  1872.  
  1873.         When  DFL initializes, it attempts to create the following  files 
  1874.         in  the root directory of the working disk (See sections 2.2.1  & 
  1875.         2.2.2):
  1876.  
  1877.           1TMP????.DFL - Subdirectory for archive file extraction.
  1878.           2TMP????.DFL - Subdirectory for archive file extraction.
  1879.  
  1880.           REDIR???.DFL - File for capturing output of external programs.
  1881.           VIRT????.DFL - Virtual memory file.
  1882.           VIRT????.DFL - Virtual memory file.
  1883.           VIRT????.DFL - Virtual memory file.
  1884.           VIRT????.DFL - Virtual memory file.
  1885.  
  1886.         These  files  are created only during the  archive  definition  & 
  1887.         testing process:
  1888.  
  1889.           FILE????.EX  - Dummy file to be archived.
  1890.           TEST????.aaa - Dummy archive to be created.
  1891.                          The extension is variable, ARC, ZIP etc.
  1892.  
  1893.         The  ?'s represent numbers from 0000 to 9999. These numeric  con-
  1894.         structs  are  used to insure unique filenames for  the  following 
  1895.         reasons:
  1896.  
  1897.         1. It  is  conceivable  that when an  external  program  receives 
  1898.            control  from DFL such as the Shell (See section III.3) or  an 
  1899.            archiver (See section IV.2.b), it crashes the system. When the 
  1900.            system is rebooted, the temporary files would still be present 
  1901.            (and possibly hidden or protected) the next time DFL ran.  See 
  1902.            section IV.4, Troubleshooting.
  1903.  
  1904.            DFL  adheres  to our policy of non-destruction  when  creating 
  1905.            temporary  files of any kind. That is, no matter how slim  the 
  1906.            chance of one of these files belonging to another program, DFL 
  1907.            will  not  overwrite  or  delete them  to  make  way  for  its 
  1908.            temporary  data. Rather, temporary filenames  are  dynamically 
  1909.            generated  to  insure that with each run DFL has  unique  disk 
  1910.            workspace.
  1911.  
  1912.         2. A  different logical drive spec may in reality, refer  to  the 
  1913.            actual working disk. Or, the working disk spec may refer to  a 
  1914.            different  logical  drive. This can cause confusion  when  DFL 
  1915.            scans both disks.
  1916.  
  1917.         3. Any of these files may already exist for a purpose other  than 
  1918.            DFL.
  1919.  
  1920.         On exit, DFL deletes these files.
  1921.                                                        Page 39
  1922.  
  1923.  
  1924.         DFL may not be able to create these files if there are not enough 
  1925.         free  entries in the root directory of the working disk. If  this 
  1926.         occurs,  DFL will exit with an error message (See  section  VI.3) 
  1927.         and you will need to use a different working disk or delete  some 
  1928.         files in the root directory. See section IV.4, Troubleshooting.
  1929.  
  1930.         When  manipulating archived files (viewing, comparing etc.),  you 
  1931.         may  notice that the file appears to be in one of  the  temporary 
  1932.         directories above. This is normal.
  1933.  
  1934.         
  1935.         6.3       DOS Stack Overflow
  1936.  
  1937.         There have been some situations reported where DFL has failed due 
  1938.         to  a "STACK OVERFLOW."  This was reported by a couple  of  users 
  1939.         who  had one of those 3rd party disk caching programs.  To  solve 
  1940.         this,  we have expanded the internal stack used by  DFL  substan-
  1941.         tially, and the problem has not been seen again when the PC TOOLS 
  1942.         cache  program "PC-CACHE.COM" is in use.
  1943.  
  1944.         However,  the stack overflow problem did recur when  a  different 
  1945.         cache  program was in use.  This was eliminated by changing  CON-
  1946.         FIG.SYS  to include the statement "STACKS=8,512".   The  original 
  1947.         statement  was   "STACKS=0,0".  This change  provides  additional 
  1948.         stack  space for OS programs.  We have not carried out  extensive 
  1949.         experiments  with all of the available cache programs, and  there 
  1950.         may be a combination of cache program and STACKS statement  which 
  1951.         cause  the  DFL stack to overflow. If you find  such  a  problem, 
  1952.         please  experiment with your STACKS statement.  If this does  not 
  1953.         solve the problem, by all means report it to us.  We will need to 
  1954.         know  the version of DOS you are using, which cache  program  and 
  1955.         parameters you have, your CONFIG.SYS file, and the type of memory 
  1956.         used  for your cache.  This will help us solve this  problem  for 
  1957.         you and anyone else who runs into it.
  1958.  
  1959.         
  1960.         6.4       Error Messages
  1961.  
  1962.         
  1963.         6.4.1     Online Errors
  1964.  
  1965.         Many  of the self-explanatory errors are signaled by a beep  from 
  1966.         the speaker.  These are errors such as:
  1967.  
  1968.             1. Typing past the end of an entry space.
  1969.             2. Entering an invalid character in a filespec.
  1970.             3. Typing 'Z' when asked to entry 'Y' or 'N'.
  1971.             4. Etc...
  1972.  
  1973.         Other  error and status report messages appear on the  screen  to 
  1974.         give you specific information if importance.  These messages  are 
  1975.         identified below in alphabetical order.
  1976.                                                        Page 40
  1977.  
  1978.  
  1979.         6.4.1.1   "<filespec> not created."
  1980.  
  1981.         This  error  may occur when you are configuring DFL to  use  your 
  1982.         particular  archive program.  During the  configuration  process, 
  1983.         DFL  will test run your archive program to confirm that the  con-
  1984.         figuration information is correct.
  1985.  
  1986.         When DFL test ran the archive program, trying to add a dummy file 
  1987.         to a non-existent archive, the new archive was not created.  This 
  1988.         indicates  that something may be wrong in your definition to  DFL 
  1989.         on how to run the "add file" option of your archive program.  You 
  1990.         should  have  seen some kind of error message  from  the  archive 
  1991.         program.  Perhaps  the  program needs more memory  to  run.   Try 
  1992.         removing any TSRs from memory before running DFL.  DFL uses about 
  1993.         340k.  The archive programs we have tested with DFL require  less 
  1994.         than 200K to run.  Since DFL itself uses 340K, you should have at 
  1995.         least  540K  available.  Run "CHKDSK" to see how much  memory  is 
  1996.         available on your system.
  1997.  
  1998.         
  1999.         6.4.1.2   "A disk drive must be selected to begin processing"
  2000.  
  2001.         This  error will occur if you try to start DFL without  selecting 
  2002.         at least one disk drive for processing.  Select function <F2> and 
  2003.         choose at least one disk for DFL to scan.
  2004.  
  2005.         
  2006.         6.4.1.3   "Can't create <filespec>"
  2007.  
  2008.         This  error  may occur when you are configuring DFL to  use  your 
  2009.         particular  archive program.  During the  configuration  process, 
  2010.         DFL  will test run your archive program to confirm that the  con-
  2011.         figuration information is correct.
  2012.  
  2013.         When  DFL attempts to test run the external archive programs,  it 
  2014.         first creates a 32k dummy file to be archived.  This error  could 
  2015.         indicate a lack of directory space, a lack of disk space, or that 
  2016.         the file <filespec> already exists.  Identify the specific  cause 
  2017.         of the problem and retry.
  2018.  
  2019.         
  2020.         6.4.1.4   "Can't extract that file."
  2021.  
  2022.         In attempting to View an archived file, DFL was unable to extract 
  2023.         it from the host archive.  Select function 'R' to see the  output 
  2024.         of  the last run archive program.  If the archive extractor  pro-
  2025.         duced any error messages, they will appear.  You may need to free 
  2026.         more  memory prior to running DFL.  Also, some  archives  contain 
  2027.         files that have been encrypted with a password. The only way  DFL 
  2028.         can  extract these files is if you add the  appropriate  password 
  2029.         option  to  the extractor program's parameter line.  See  section 
  2030.         4.2.2.
  2031.                                                        Page 41
  2032.  
  2033.  
  2034.         6.4.1.5   "Can't find that program. Try again."
  2035.  
  2036.         You are trying to enter the name of an external program. If it is 
  2037.         not on the path, you must specify drive and directory along  with 
  2038.         the  filename. If you do not specify the extension, DFL will  try 
  2039.         COM and then EXE before giving up.
  2040.  
  2041.         
  2042.         6.4.1.6   "Can't log to disk"
  2043.  
  2044.         You tried to display the statistics of an invalid drive.
  2045.  
  2046.         
  2047.         6.4.1.7   "Can't open current file."
  2048.  
  2049.         DFL was unable to access either the marked file or the file under 
  2050.         the  cursor bar for the comparison function. If the file  is  ar-
  2051.         chived,  select  function 'R' to see the output of the  last  run 
  2052.         external  program.  If the archive extractor produced  any  error 
  2053.         messages, they will appear here. You may need to free more memory 
  2054.         prior to running DFL. Also, some archives contain files that have 
  2055.         been  encrypted  with a password. The only way  DFL  can  extract 
  2056.         these files is if you add the appropriate password option to  the 
  2057.         extractor program's parameter line. See section IV.2.b.
  2058.  
  2059.         If the file is not archived, then you are faced with a  situation 
  2060.         where  DFL    has  in memory the name of a file the  was  scanned  
  2061.         moments earlier but doesn't exist now. This can happen if you are 
  2062.         running  in  a multitasking environment and  other  programs  are 
  2063.         'diddling'  things  in the background. Perhaps one of  the  back-
  2064.         ground  programs  deleted the requested file. DFL has no  way  of 
  2065.         knowing what other programs or TSRs are during in the background.
  2066.  
  2067.         
  2068.         6.4.1.8   "Can't open marked file."
  2069.  
  2070.         DFL was unable to access either the marked file or the file under 
  2071.         the  cursor bar for the comparison function. If the file  is  ar-
  2072.         chived,  select  function 'R' to see the output of the  last  run 
  2073.         external  program.  If the archive extractor produced  any  error 
  2074.         messages, they will appear here. You may need to free more memory 
  2075.         prior to running DFL. Also, some archives contain files that have 
  2076.         been  encrypted  with a password. The only way  DFL  can  extract 
  2077.         these files is if you add the appropriate password option to  the 
  2078.         extractor program's parameter line. See section IV.2.b.
  2079.  
  2080.         If the file is not archived, then you are faced with a  situation 
  2081.         where  DFL    has  in memory the name of a file the  was  scanned  
  2082.         moments earlier but doesn't exist now. This can happen if you are 
  2083.         running  in  a multitasking environment and  other  programs  are 
  2084.         'diddling'  things  in the background. Perhaps one of  the  back-
  2085.         ground  programs  deleted the requested file. DFL has no  way  of 
  2086.         knowing what other programs or TSRs are during in the background.
  2087.                                                        Page 42
  2088.  
  2089.  
  2090.         6.4.1.9   "Can't run C:\COMMAND.COM"
  2091.  
  2092.         There  was some problem in loading and executing COMMAND.COM  for 
  2093.         the  Dos  Shell function.  The path and filename of  the  command 
  2094.         processor are sought using the environment variable COMSPEC.   If 
  2095.         that is not found, DFL defaults to C:\COMMAND.COM.
  2096.  
  2097.         
  2098.         6.4.1.10  "DFL is unable to run that program"
  2099.  
  2100.         There was some problem in loading and executing the corresponding 
  2101.         archive program.  It may be too big, or not exist at all.
  2102.  
  2103.         
  2104.         6.4.1.11  "DFL temporary files have been damaged. Must exit."
  2105.  
  2106.         When  the Dos Shell function is invoked, DFL hides  and  protects 
  2107.         all  of its temporary files and directories.  On return from  the 
  2108.         Shell,  they are unhidden and unprotected.  If DFL is  unable  to 
  2109.         restore any of them, it must exit.
  2110.  
  2111.         
  2112.         6.4.1.12  "Different size files can't be the same."
  2113.  
  2114.         The  binary byte-by-byte comparison function is useless for  dif-
  2115.         ferent  length files. Use the external ASCII  comparison  program 
  2116.         for different length ascii files.
  2117.  
  2118.         
  2119.         6.4.1.13  "FC.EXE produced no results."
  2120.  
  2121.         The ASCII comparison just performed produced no output.
  2122.  
  2123.         
  2124.         6.4.1.14  "Files are not equal."  &  "Files are the same."
  2125.  
  2126.         Possible results from the binary comparison.
  2127.  
  2128.         
  2129.         6.4.1.15  "Must specify '%1' and '%2' parameters."
  2130.  
  2131.         DFL  must pass the archive extractor, adder and deleter  programs 
  2132.         at  least two parameters: the archive filename and  the  archived 
  2133.         file.  You  must indicate where these belong with '%1'  and  '%2' 
  2134.         respectively as if they were run from the command line.
  2135.  
  2136.         
  2137.         6.4.1.16  "Must specify '%1' parameter."
  2138.  
  2139.         DFL must pass the archive lister program at least one  parameter, 
  2140.         the  archive filename.  You must indicate where it  belongs  with 
  2141.         '%1' as if it was run from the command line.
  2142.                                                        Page 43
  2143.  
  2144.  
  2145.         6.4.1.17  "No duplicate files in list.  Function canceled."
  2146.  
  2147.         The requested function will not operate without a list of  dupli-
  2148.         cates.
  2149.  
  2150.  
  2151.         6.4.1.18  "No file is marked."
  2152.  
  2153.         You  must mark a file using the F6 key that you wish compared  to 
  2154.         the one under the cursor bar.
  2155.  
  2156.         
  2157.         6.4.1.19  "No files have been tagged.  Function canceled."
  2158.  
  2159.         The untag function will not work if there are no tagged files.
  2160.  
  2161.         
  2162.         6.4.1.20  "No output available"
  2163.  
  2164.         The  See  Results function will only show you the output  of  the 
  2165.         last  executed  external program if it was  captured.  Currently, 
  2166.         there is none.
  2167.  
  2168.         
  2169.         6.4.1.21  "Not enough memory."  &  "Out of memory."
  2170.  
  2171.         The requested function needs more memory.  Usually, this is about 
  2172.         4k.   If you see this error, you're really pushing the  envelope.  
  2173.         Try to remove any TSR programs or reduce the size of the environ-
  2174.         ment space.
  2175.  
  2176.         
  2177.         6.4.1.22  "Problem creating dummy file"
  2178.  
  2179.         To  test  the archive definition, DFL creates a  32k  dummy  file 
  2180.         named TEST????.aaa.  See section 6.1.  This error indicates  that 
  2181.         DFL was unable to create the temporary file.
  2182.  
  2183.         
  2184.         6.4.1.23  "Problem extracting current file."
  2185.  
  2186.         The  file comparison functions must extract any compressed  files 
  2187.         before  performing the compare.  Select function 'R' to  see  the 
  2188.         output of the last run external program.  If the archive  extrac-
  2189.         tor produced any error messages, they will appear here.  You  may 
  2190.         need  to free more memory prior to running DFL.  Also,  some  ar-
  2191.         chives  contain files that have been encrypted with  a  password.  
  2192.         The only way DFL can extract these files is if you add the appro-
  2193.         priate password option to the extractor program's parameter line.  
  2194.         See section 4.2.2.
  2195.                                                        Page 44
  2196.  
  2197.  
  2198.         6.4.1.24  "Problem extracting marked file."
  2199.  
  2200.         The  file comparison functions must extract any compressed  files 
  2201.         before  performing the compare.  Select function 'R' to  see  the 
  2202.         output of the last run external program.  If the archive  extrac-
  2203.         tor produced any error messages, they will appear here.  You  may 
  2204.         need  to free more memory prior to running DFL.  Also,  some  ar-
  2205.         chives  contain files that have been encrypted with  a  password.  
  2206.         The only way DFL can extract these files is if you add the appro-
  2207.         priate password option to the extractor program's parameter line.  
  2208.         See section 4.2.2.
  2209.  
  2210.         
  2211.         6.4.1.25  "Problem running <archive lister>"
  2212.  
  2213.         This error will occur during the disk scan if DFL cannot  execute 
  2214.         the  lister  program for an archive type that has  been  enabled.  
  2215.         You  may  need to free more memory prior to running  DFL.  Select 
  2216.         function 'R' to see the output of the last run external  program.  
  2217.         If  the  archive lister produced any error  messages,  they  will 
  2218.         appear here.
  2219.  
  2220.         
  2221.         6.4.1.26  "Problem running FC.EXE.  Check FC.EXE rules under 
  2222.                   setup."
  2223.  
  2224.         This error will occur if DFL cannot execute the ascii  comparison 
  2225.         program.  You may need to free more memory prior to running  DFL.  
  2226.         Select  function 'R' to see the output of the last  run  external 
  2227.         program.  If the program produced any error messages,  they  will 
  2228.         appear here.
  2229.  
  2230.         
  2231.         6.4.1.27  "Problem running that program"
  2232.  
  2233.         This  error will occur if DFL cannot execute one of  the  archive 
  2234.         programs  during the test run.  You may need to free more  memory 
  2235.         prior  to running DFL.  Select function 'R' to see the output  of 
  2236.         the last run external program.  If the program produced any error 
  2237.         messages, they may appear here.
  2238.  
  2239.         
  2240.         6.4.1.28  "Problem writing <filename>"
  2241.  
  2242.         The  duplicate  list output function encountered an  error  while 
  2243.         writing the given file.  If you're writing to a floppy, make sure 
  2244.         the  disk is formatted and properly inserted in the drive.  Also, 
  2245.         you  may have run out of disk space, especially if the  duplicate 
  2246.         list is long.
  2247.                                                        Page 45
  2248.  
  2249.  
  2250.         6.4.1.29  "That extension is invalid."
  2251.  
  2252.         If any of these characters are used in the extension field of the 
  2253.         archive  definition, it will be declared invalid- ".*?\/:".  This 
  2254.         doesn't include the quotes.
  2255.  
  2256.         
  2257.         6.4.1.30  "That is a DIRECTORY. Hit a key..."
  2258.  
  2259.         This  error will occur if you enter an invalid list output  file-
  2260.         name.
  2261.  
  2262.  
  2263.         6.4.1.31  "That is a HIDDEN or SYSTEM file. Hit a key..."
  2264.  
  2265.         This  error will occur if you enter an invalid list output  file-
  2266.         name.
  2267.  
  2268.         
  2269.         6.4.1.32  "That is a READ ONLY file. Hit a key..."
  2270.  
  2271.         This  error will occur if you enter an invalid list output  file-
  2272.         name.
  2273.  
  2274.         
  2275.         6.4.1.33  "That's not a file !"
  2276.  
  2277.         This  error  is caused by attempting to perform one of  the  file 
  2278.         operations  on the blank divider lines between the groups in  the 
  2279.         duplicate list window.
  2280.  
  2281.         
  2282.         6.4.1.34  "The viewer couldn't open that file"
  2283.  
  2284.         The viewing system was unable to access the file under the cursor 
  2285.         bar.  If the file is archived, then DFL attempted to extract  it.  
  2286.         Select  function 'R' to see the output of the last  run  external 
  2287.         program.  If the archive extractor produced any  error  messages, 
  2288.         they will appear here.  You may need to free more memory prior to 
  2289.         running  DFL.  Also, some archives contain files that  have  been 
  2290.         encrypted  with a password.  The only way DFL can  extract  these 
  2291.         files  is if you add the appropriate password option to  the  ex-
  2292.         tractor program's parameter line.  See section 4.2.2.
  2293.  
  2294.         If the file is not archived, then you are faced with a  situation 
  2295.         where  DFL has in memory the name of a file the was  scanned  mo-
  2296.         ments earlier but  doesn't exist now.  This can happen if you are 
  2297.         running  in  a multitasking environment and  other  programs  are 
  2298.         'diddling'  things in the background.  Perhaps one of  the  back-
  2299.         ground  programs deleted the requested file.  DFL has no  way  of 
  2300.         knowing  what is happening while TSRs or background programs  are 
  2301.         active.
  2302.                                                        Page 46
  2303.  
  2304.  
  2305.         6.4.1.35  "The viewer needs about 16k more memory"
  2306.  
  2307.         The  viewing system needs about 16k of memory.  If you  see  this 
  2308.         error, you're pushing the envelope.  Try freeing some TSRs before 
  2309.         running DFL.
  2310.  
  2311.         
  2312.         6.4.1.36  "Too many lines/entry. May not work."
  2313.  
  2314.         The format of the archive lister output should not take more than 
  2315.         about 15 lines per file entry.
  2316.  
  2317.         6.4.1.37  "Unable to open the file. Hit a key..."
  2318.  
  2319.         The duplicate list output function was not able to open the given 
  2320.         file.  If you're writing to a floppy, make sure the disk is  for-
  2321.         matted and properly inserted in the drive.
  2322.  
  2323.         
  2324.         6.4.1.38  "Use caution in selecting an output path"
  2325.  
  2326.         In preparing to write the duplicate list, DFL changes back to the 
  2327.         original disk from where it was invoked. If it has trouble  doing 
  2328.         that,  this warning will be displayed before you are prompted  to 
  2329.         enter  the output filename. It means that the disk  configuration 
  2330.         has probably changed since DFL was started and subsequent caution 
  2331.         is  advised.  This may happen if you run DFL from  a  floppy  and 
  2332.         remove the floppy.
  2333.  
  2334.         
  2335.         6.4.1.39  "Why compare a file to itself ?"
  2336.  
  2337.         This is self-explanatory.
  2338.  
  2339.         
  2340.         6.4.1.40  "Why view a file of 0 length ?"
  2341.  
  2342.         This is self-explanatory.
  2343.  
  2344.         
  2345.         6.4.1.41  "You must edit the definition before enabling it."
  2346.  
  2347.         You can't enable an undefined or uninitialized archive type.
  2348.  
  2349.         6.4.1.42   "Bad file: <arcfile>"
  2350.         6.4.1.43   "Read error: <arcfile>"
  2351.         6.4.1.44   "Seek error: <arcfile>"
  2352.         6.4.1.45   "Can't open: <arcfile>"
  2353.         6.4.1.46   "Bad name field: <arcfile>"
  2354.  
  2355.         These  errors can occur when DFL is directly reading an  archive. 
  2356.         The corresponding archive is probably damaged.
  2357.                                                        Page 47
  2358.  
  2359.  
  2360.         6.4.2     Exit Errors
  2361.  
  2362.         The  error messages below are reported when the execution of  DFL 
  2363.         must be aborted due to some fatal error condition.
  2364.  
  2365.         6.4.2.1   "Virtual memory file CRITICAL READ error..."
  2366.  
  2367.         An interpretation window will accompany this message.  This error 
  2368.         may occur if you run out of disk space or an actual error  occurs 
  2369.         on the working disk.
  2370.  
  2371.         6.4.2.2   "Virtual memory file CRITICAL SEEK error..."
  2372.  
  2373.         An interpretation window will accompany this message.  This error 
  2374.         may occur if you run out of disk space or an actual error  occurs 
  2375.         on the working disk.
  2376.  
  2377.  
  2378.         6.4.2.3   "Virtual memory file CRITICAL WRITE error..."
  2379.  
  2380.         An interpretation window will accompany this message.  This error 
  2381.         may occur if you run out of disk space or an actual error  occurs 
  2382.         on the working disk.
  2383.  
  2384.         
  2385.         6.4.2.4   "Virtual memory file READ error..."
  2386.  
  2387.         An interpretation window will accompany this message.  This error 
  2388.         may occur if you run out of disk space or an actual error  occurs 
  2389.         on the working disk.
  2390.  
  2391.         
  2392.         6.4.2.5   "Virtual memory file SEEK error..."
  2393.  
  2394.         An interpretation window will accompany this message.  This error 
  2395.         may occur if you run out of disk space or an actual error  occurs 
  2396.         on the working disk.
  2397.  
  2398.         
  2399.         6.4.2.6   "Virtual memory file WRITE error..."
  2400.  
  2401.         An interpretation window will accompany this message.  This error 
  2402.         may occur if you run out of disk space or an actual error  occurs 
  2403.         on the working disk.
  2404.  
  2405.         
  2406.         6.4.2.7   "Disk specified by '/w=' unavailable."
  2407.  
  2408.         The requested working disk is not accessible by DFL.
  2409.                                                        Page 48
  2410.  
  2411.  
  2412.         6.4.2.8   "Bad filename mask in '/f=' option."
  2413.  
  2414.         The filename mask follows standard Dos filespec syntax  including 
  2415.         wildcards.  Use 'A*.*' to scan all files beginning with 'A'.  Use 
  2416.         '*.EXE' to scan all EXE files.
  2417.  
  2418.         6.4.2.9   "Syntax error in '/d=' option."
  2419.  
  2420.         To  specify  drives  'C:' and 'D:' as the  scan  disks  use  'DFL 
  2421.         /d=cd'.   This is not case-sensitive.  The command  line  options 
  2422.         are  all  separated  by spaces. Type 'DFL /?' to  obtain  a  help 
  2423.         listing with an example of each option.
  2424.  
  2425.         6.4.2.10  "Syntax error in '/f=' option."
  2426.  
  2427.         To use '*.bak' as the filename mask type 'DFL /f=*.bak'.  This is 
  2428.         not case- sensitive.  The command line options are all  separated 
  2429.         by spaces.  Type 'DFL /?' to obtain a help listing with an  exam-
  2430.         ple of each option.
  2431.  
  2432.  
  2433.         6.4.2.11  "Syntax error in '/l(a/w)=' option."
  2434.  
  2435.         To   specify   c:\dfl.lst   as  the   output   file,   use   'DFL 
  2436.         /lw=c:\dfl.lst'.   To  append  the  duplicate  list   output   to 
  2437.         c:\dfl.lst,  use 'DFL /la=c:\dfl.lst'. These are not  case-sensi-
  2438.         tive.   The  command line options are all  separated  by  spaces.  
  2439.         Type  'DFL /?' to obtain a help listing with an example  of  each 
  2440.         option.
  2441.         
  2442.         6.4.2.12  "Syntax error in '/m=' option."
  2443.  
  2444.         To  use  the ALIAS mode type 'DFL /m=alias'.  This is  not  case-
  2445.         sensitive.  The command line options are all separated by spaces.  
  2446.         Type  'DFL /?' to obtain a help listing with an example  of  each 
  2447.         option.
  2448.  
  2449.         
  2450.         6.4.2.13  "Syntax error in '/w=' option."
  2451.  
  2452.         To  specify drive 'D:' as the working disk use 'DFL /w=d'.   This 
  2453.         is  not case- sensitive.  The command line options are all  sepa-
  2454.         rated by spaces.  Type 'DFL /?' to obtain a help listing with  an 
  2455.         example of each option.
  2456.  
  2457.         
  2458.         6.4.2.14  "Bad output filename."
  2459.  
  2460.         The  error  results  if the file specified by  the  command  line 
  2461.         option '/l(a/w)=' is not accessible by DFL.  If the file is on  a 
  2462.         floppy, make sure the disk is formatted and properly inserted  in 
  2463.         the drive.
  2464.